rs-validate

Run tests against a RootSpec specification and write results to rootspec/tests-status.json.

Updated Nov 7, 2025
One-click install
npx skills add https://github.com/rootspec/rootspec --skill rs-validate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rs-validate
Source: https://github.com/rootspec/rootspec/tree/main/skills/rs-validate
Command: npx skills add https://github.com/rootspec/rootspec --skill rs-validate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validating that a RootSpec's implementation aligns with its specification by running automated tests and producing a concise, shareable report.

Core Features & Use Cases

  • Non-interactive test execution that validates a spec-driven implementation.
  • Progress is recorded to rootspec/tests-status.json for easy tracking and auditing.
  • Includes pre-flight checks to ensure tests are ready and reliable before execution.

Quick Start

Run the validation workflow to execute tests and produce a results report at rootspec/tests-status.json.

Frequently Asked Questions about rs-validate

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

FAQPage Schema
How do I validate automated tests against a RootSpec specification?

To validate automated tests against a RootSpec specification, run the validation workflow in non-interactive mode. It executes your configured test runner and generates a clear results report tracking per-story and per-criterion status.

How does the RootSpec validation workflow record test results?

The RootSpec validation workflow records test results by writing per-story status and per-criterion outcomes directly into the rootspec/tests-status.json file. This provides easy progress tracking and auditing for your test suite.

Can I use Cypress to run RootSpec validation tests?

Yes, you can use Cypress to run RootSpec validation tests. The workflow relies on your project's configured test runner, such as Cypress, to execute the automated tests and validate your spec-driven implementation.

What is the best way to ensure automated tests are ready before CI execution?

The best way to ensure automated tests are ready before CI execution is to run pre-flight checks. The validation workflow includes these pre-run checks to verify tests are reliable and properly configured before execution begins.

Does the RootSpec validation workflow support interactive test debugging?

No, the RootSpec validation workflow does not support interactive test debugging. It operates strictly in non-interactive mode to automatically execute tests and produce a concise, shareable results report without user intervention.