fp-review-spec

Validate E2E_TESTS.md structure, metadata, and quality without modifying files.

6|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/endorhq/flightplanner --skill fp-review-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fp-review-spec
Source: https://github.com/endorhq/flightplanner/tree/main/skills/fp-review-spec
Command: npx skills add https://github.com/endorhq/flightplanner --skill fp-review-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about fp-review-spec

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

FAQPage Schema
How do I validate E2E test specification structure for AI agents?

To validate E2E test specification structure, check the E2E_TESTS.md file for required sections like Index, Suites, Preconditions, Features, and Postconditions. This ensures AI agents can reliably parse and generate tests from well-formed markdown documentation.

What is declarative writing style validation for E2E test documentation?

Declarative writing style validation for E2E test documentation checks for vague assertions and incorrect tense usage in E2E_TESTS.md files. It reports quality issues without modifying files, ensuring test specifications remain clear and actionable for automated generation.

How do I verify metadata comments in markdown test specifications?

To verify metadata comments in markdown test specifications, scan E2E_TESTS.md files for required tags like <!-- category: ... --> and <!-- skip: ... -->. This process ensures metadata values are present and valid for proper test automation workflow configuration.

Can I check for missing error categories in E2E test suites?

You can check for missing error categories in E2E test suites by analyzing feature category coverage within E2E_TESTS.md files. This analysis provides warnings for missing critical categories like 'error' and informational notes for optional ones, ensuring comprehensive test coverage.

Does validating E2E test specs modify my original markdown files?

Validating E2E test specs does not modify your original markdown files. The validation process strictly reports findings regarding structure, metadata, and quality issues in E2E_TESTS.md files, ensuring your test documentation remains untouched during the review process.

What are common quality issues in E2E test specifications?

Common quality issues in E2E test specifications include duplicate feature names, non-achievable preconditions, vague assertions, and incorrect tense usage. Identifying these issues ensures comprehensive and well-formed E2E test documentation for reliable AI agent workflow execution.