ralph-val

Validate code implementations against plan requirements and post results to GitHub.

2|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/cdubiel08/ralph-hero --skill ralph-val
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-val
Source: https://github.com/cdubiel08/ralph-hero/tree/main/plugin/ralph-hero/skills/ralph-val
Command: npx skills add https://github.com/cdubiel08/ralph-hero --skill ralph-val

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures that code implementations accurately meet the defined requirements and success criteria outlined in an implementation plan, preventing the creation of pull requests with unmet specifications.

Core Features & Use Cases

  • Automated Verification: Executes predefined checks (file existence, command execution, content matching) against the implemented code.
  • Plan Adherence: Verifies that the "Desired End State" and specific "Success Criteria" from the plan are satisfied.
  • Use Case: After a developer implements a feature based on a plan, use this Skill to automatically run tests, check for required files, and verify specific output patterns before a pull request is even created.

Quick Start

Use the ralph-val skill to validate the implementation for issue number 123.

Frequently Asked Questions about ralph-val

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

FAQPage Schema
How do I validate code implementation against plan requirements before creating a pull request?

To validate code implementation against plan requirements, the skill parses plan documents to extract automated verification steps, including file checks, command executions, and content pattern matching. It reports a PASS or FAIL verdict based on whether the code satisfies the success criteria.

What is automated plan adherence verification in CI/CD?

Automated plan adherence verification in CI/CD is the process of checking if code implementations meet predefined success criteria from a plan document. It executes file checks, runs commands, and matches content patterns to prevent merging code that fails to meet specifications.

How do I check for specific file existence and output patterns in a GitHub worktree?

You can check for specific file existence and output patterns in a GitHub worktree by using a validation skill that parses your plan document. It automatically executes these predefined checks against the implemented code within the specified worktree directory and posts the results as a GitHub comment.

Does the validation skill work with GitHub Actions and issue numbers?

Yes, the validation skill works with GitHub Actions and operates on a given issue number. It processes the implementation within a specified worktree and posts the PASS or FAIL validation results directly as a GitHub comment.

Can I use a custom plan document path for code review validation?

Yes, you can use a custom plan document path for code review validation. The skill accepts an optional plan document path argument alongside the required issue number to extract and execute the specific automated verification steps.

What are the limitations of automated code validation against plan requirements?

The limitations of automated code validation against plan requirements include its reliance on predefined checks within the plan document. It can only verify explicit success criteria like file existence, command execution, and content patterns, meaning implicit requirements or complex logic errors might not be caught.