# 014 Agile Create User Story

> Guides the creation of agile user stories and Gherkin feature files. Use when the user wants to create a user story, write acceptance criteria, define Gherkin scenarios, or author BDD feature files. Part of the skills-for-java project

- Skill: `majiayu000/014-agile-create-user-story` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/014-agile-create-user-story`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/014-agile-create-user-story/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: Apache-2.0
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/014-agile-create-user-story

---

# 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

## 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

## When to use this skill

- Create a user story
- Write a user story
- I need a user story

## Reference

For detailed guidance, examples, and constraints, see [references/014-agile-create-user-story.md](references/014-agile-create-user-story.md).