ralph-test-executor

Execute Ralph's testing plan from 05-test-plan.md with npm and MCP checks.

12|5|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/ylubi/Trae-Ralph --skill ralph-test-executor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-test-executor
Source: https://github.com/ylubi/Trae-Ralph/tree/main/templates/skills/ralph-test-executor
Command: npx skills add https://github.com/ylubi/Trae-Ralph --skill ralph-test-executor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the execution of Ralph's Testing Phase by reading and enforcing the steps in 05-test-plan.md, ensuring traceable test results and status updates.

Core Features & Use Cases

  • Sequential test execution: Reads 05-test-plan.md from top to bottom and runs each pending test in order.
  • Automated verification & state sync: Updates RALPH_STATE.md with progress and reconciles discrepancies between plan and state.
  • Flexible execution modes: Supports unit/integration tests via npm test and MCP-based UI testing, with automated blocking, comments, and auto-fix attempts.

Quick Start

Start the automated testing loop to execute the first pending test in 05-test-plan.md.

Frequently Asked Questions about ralph-test-executor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate sequential test plan execution from a markdown file?

Automating sequential test plan execution requires reading 05-test-plan.md from top to bottom and running each pending test in strict order. The skill enforces sequential execution, blocking, and state synchronization across all defined test cases.

How does automated test state synchronization work with RALPH_STATE.md?

Automated test state synchronization works by updating RALPH_STATE.md with progress after each test case and reconciling discrepancies between the plan and state. This ensures traceable test results and accurate status tracking throughout the testing phase.

Can I run both npm test suites and MCP-based UI checks in the same automated workflow?

You can run both npm test suites and MCP-based UI checks in the same workflow. The execution supports unit and integration tests via npm test, while utilizing MCP tooling specifically for automated UI testing.

What do I need to set up before automating test execution with this approach?

Before automating test execution, you need a compliant 05-test-plan.md containing test cases, a RALPH_STATE.md file for tracking progress, and available scripts in the scripts/ directory to perform the automated steps.

Does automated test execution support auto-fix attempts for failing cases?

Automated test execution supports auto-fix attempts for failing cases. It applies automated blocking, comments, and auto-fix mechanisms when processing test plans, addressing issues before proceeding to subsequent tests.