What problem does it solve?
This Skill helps you create clear, testable Gherkin feature specifications without guessing the repository's conventions or missing important scenarios. It reduces the risk of vague, incomplete, or misleading specs by guiding you through the right questions before writing the .feature file.
Core Features & Use Cases
- Repository-aware spec writing: Finds the existing specs location, naming style, tagging patterns, and phrasing conventions so new feature files fit the codebase.
- Interactive scenario discovery: Draws out the golden path, edge cases, error paths, and scope boundaries through conversation instead of jumping straight to a weak draft.
- Context linking: Looks for related ADRs or PR context and connects the spec to prior design decisions when relevant.
- Validation-oriented workflow: Encourages review, writes the final .feature file, and verifies Gherkin syntax with a dry run when a BDD runner is available.
- Use case: When a team wants to document a new or existing feature in Cucumber, Behave, SpecFlow, or pytest-bdd style, this Skill helps produce a concrete, maintainable spec that matches local practice.
Quick Start
Ask the write-spec skill to draft a Gherkin feature file for the behavior you want to capture and be ready to answer a few questions about the main flow, edge cases, and expected outcomes.