fp-review-spec

What problem does it solve?

This Skill addresses the challenge of maintaining high-quality, consistent End-to-End (E2E) test specifications by automating their validation. It ensures that E2E_TESTS.md files are comprehensive, well-structured, and adhere to defined standards, preventing errors and improving the reliability of AI-generated tests.

Core Features & Use Cases

• Structure Validation: Checks for the presence and correct formatting of essential sections like Index, Suites, Preconditions, Features, and Postconditions.
• Metadata Verification: Ensures required metadata comments (e.g., <!-- category: ... -->, <!-- skip: ... -->) are present and use valid values.
• Quality Assurance: Identifies potential issues such as duplicate feature names, non-achievable preconditions, vague assertions, and incorrect tense usage.
• Category Coverage Analysis: Assesses the diversity of feature categories within suites, providing warnings for missing critical categories like 'error' and informational notes for optional ones.
• Use Case: Before committing changes to E2E test specifications, run this Skill to catch any structural or metadata errors, ensuring that AI agents can reliably generate and maintain tests based on these specs.

Quick Start

Run the fp-review-spec skill to validate all E2E_TESTS.md files in the current project.