Create Agile User Stories and Gherkin Feature Files

Guide the agent to ask targeted questions to gather details for a user story and its Gherkin acceptance criteria, then generate a Markdown user story and a separate Gherkin .feature file. This is an interactive SKILL.

What is covered in this Skill?

• User story core details: title, persona, goal, benefit
• Gherkin feature file: Feature name, background steps, scenarios
• Acceptance criteria: Given / When / Then with data examples
• File naming and linking between user story and feature file
• INVEST quality validation before finalization (Independent, Negotiable, Valuable, Estimable, Small, Testable)

Constraints

Before generating artifacts, gather all required information through structured questions. Use exact wording from the template and wait for user responses.

• MANDATORY: Ask questions from the template one-by-one in strict order before generating any artifacts
• MUST: Read the reference template fresh and use exact wording—do not use cached questions
• MUST: Wait for user response after each question or block before proceeding
• MUST: Repeat scenario questions for each additional scenario when user indicates more scenarios
• MUST: Validate the final user story against INVEST and present a pass/fail checkpoint for each criterion before finalizing

When to use this skill

• Create a user story
• Write a user story
• I need to write a user story

Reference

For detailed guidance, examples, and constraints, see references/014-agile-user-story.md.