{"id":"93ee6b2a-d124-4984-924e-c4a260c8b287","shortId":"AekrA9","kind":"skill","title":"014-agile-user-story","tagline":"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. This should trigger for requests such as Create a user story; Write a user story;","description":"# Create Agile User Stories and Gherkin Feature Files\n\nGuide 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**.\n\n**What is covered in this Skill?**\n\n- User story core details: title, persona, goal, benefit\n- Gherkin feature file: Feature name, background steps, scenarios\n- Acceptance criteria: Given / When / Then with data examples\n- File naming and linking between user story and feature file\n- INVEST quality validation before finalization (Independent, Negotiable, Valuable, Estimable, Small, Testable)\n\n## Constraints\n\nBefore generating artifacts, gather all required information through structured questions. Use exact wording from the template and wait for user responses.\n\n- **MANDATORY**: Ask questions from the template one-by-one in strict order before generating any artifacts\n- **MUST**: Read the reference template fresh and use exact wording—do not use cached questions\n- **MUST**: Wait for user response after each question or block before proceeding\n- **MUST**: Repeat scenario questions for each additional scenario when user indicates more scenarios\n- **MUST**: Validate the final user story against INVEST and present a pass/fail checkpoint for each criterion before finalizing\n\n## When to use this skill\n\n- Create a user story\n- Write a user story\n- I need to write a user story\n\n## Workflow\n\n1. **Gather story and scenario details**\n\nRun the interactive questionnaire in strict order and wait for user responses before moving to the next question block.\n\nStep constraints:\n- Use the exact wording from the referenced template\n- Repeat scenario questions for each additional scenario requested by the user\n\n2. **Generate the two artifacts**\n\nCreate the user story Markdown and Gherkin `.feature` content using only gathered inputs, including links between files and scenario tags.\n\n3. **Validate quality before finalizing**\n\nCheck output completeness and provide an INVEST pass/fail checkpoint with concrete evidence for each criterion.\n\n## Reference\n\nFor detailed guidance, examples, and constraints, see [references/014-agile-user-story.md](references/014-agile-user-story.md).","tags":["014","agile","user","story","cursor","rules","java","jabrena","agent-skills","ai-skills","claude","claude-code"],"capabilities":["skill","source-jabrena","skill-014-agile-user-story","topic-agent-skills","topic-ai-skills","topic-claude","topic-claude-code","topic-claude-code-skills","topic-claude-code-subagents","topic-claude-skills","topic-cursor-agent","topic-cursor-ai","topic-cursor-skills","topic-cursorai","topic-github-copilot"],"categories":["cursor-rules-java"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/jabrena/cursor-rules-java/014-agile-user-story","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add jabrena/cursor-rules-java","source_repo":"https://github.com/jabrena/cursor-rules-java","install_from":"skills.sh"}},"qualityScore":"0.631","qualityRationale":"deterministic score 0.63 from registry signals: · indexed on github topic:agent-skills · 362 github stars · SKILL.md body (2,268 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-26T18:53:39.692Z","embedding":null,"createdAt":"2026-04-18T22:01:43.339Z","updatedAt":"2026-04-26T18:53:39.692Z","lastSeenAt":"2026-04-26T18:53:39.692Z","tsv":"'014':1 '1':266 '2':312 '3':337 'accept':28,78,119 'addit':220,306 'agent':63 'agil':3,10,54 'agile-user-stori':2 'artifact':151,186,316 'ask':65,171 'author':34 'background':116 'bdd':35 'benefit':110 'block':211,290 'cach':200 'check':342 'checkpoint':239,350 'complet':344 'concret':352 'constraint':148,292,363 'content':325 'core':105 'cover':99 'creat':23,45,53,250,317 'creation':8 'criteria':29,79,120 'criterion':242,356 'data':125 'defin':30 'detail':70,106,271,359 'estim':145 'evid':353 'exact':160,195,295 'exampl':126,361 'featur':15,36,59,90,112,114,135,324 'file':16,37,60,91,113,127,136,333 'final':141,230,244,341 'fresh':192 'gather':69,152,267,328 'generat':81,150,184,313 'gherkin':14,31,58,77,89,111,323 'given':121 'goal':109 'guid':6,61 'guidanc':360 'includ':330 'independ':142 'indic':224 'inform':155 'input':329 'interact':95,274 'invest':137,234,348 'link':130,331 'mandatori':170 'markdown':83,321 'move':285 'must':187,202,214,227 'name':115,128 'need':259 'negoti':143 'next':288 'one':177,179 'one-by-on':176 'order':182,278 'output':343 'pass/fail':238,349 'persona':108 'present':236 'proceed':213 'provid':346 'qualiti':138,339 'question':67,158,172,201,209,217,289,303 'questionnair':275 'read':188 'refer':190,357 'referenc':299 'references/014-agile-user-story.md':365,366 'repeat':215,301 'request':42,308 'requir':154 'respons':169,206,283 'run':272 'scenario':32,118,216,221,226,270,302,307,335 'see':364 'separ':88 'skill':96,102,249 'skill-014-agile-user-story' 'small':146 'source-jabrena' 'step':117,291 'stori':5,12,26,48,52,56,74,85,104,133,232,253,257,264,268,320 'strict':181,277 'structur':157 'tag':336 'target':66 'templat':164,175,191,300 'testabl':147 'titl':107 'topic-agent-skills' 'topic-ai-skills' 'topic-claude' 'topic-claude-code' 'topic-claude-code-skills' 'topic-claude-code-subagents' 'topic-claude-skills' 'topic-cursor-agent' 'topic-cursor-ai' 'topic-cursor-skills' 'topic-cursorai' 'topic-github-copilot' 'trigger':40 'two':315 'use':17,159,194,199,247,293,326 'user':4,11,20,25,47,51,55,73,84,103,132,168,205,223,231,252,256,263,282,311,319 'valid':139,228,338 'valuabl':144 'wait':166,203,280 'want':21 'word':161,196,296 'workflow':265 'write':27,49,254,261","prices":[{"id":"1b556376-a794-4423-9c5e-5ebfe70684f2","listingId":"93ee6b2a-d124-4984-924e-c4a260c8b287","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"jabrena","category":"cursor-rules-java","install_from":"skills.sh"},"createdAt":"2026-04-18T22:01:43.339Z"}],"sources":[{"listingId":"93ee6b2a-d124-4984-924e-c4a260c8b287","source":"github","sourceId":"jabrena/cursor-rules-java/014-agile-user-story","sourceUrl":"https://github.com/jabrena/cursor-rules-java/tree/main/skills/014-agile-user-story","isPrimary":false,"firstSeenAt":"2026-04-18T22:01:43.339Z","lastSeenAt":"2026-04-26T18:53:39.692Z"}],"details":{"listingId":"93ee6b2a-d124-4984-924e-c4a260c8b287","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"jabrena","slug":"014-agile-user-story","github":{"repo":"jabrena/cursor-rules-java","stars":362,"topics":["agent-skills","ai-skills","claude","claude-code","claude-code-skills","claude-code-subagents","claude-skills","cursor-agent","cursor-ai","cursor-skills","cursorai","github-copilot","intellij-idea","java","prompting","system-prompts"],"license":"apache-2.0","html_url":"https://github.com/jabrena/cursor-rules-java","pushed_at":"2026-04-26T13:48:39Z","description":"A curated and opinionated collection of Skills and Agents to be used in modern SDLC workflows for Java Enterprise development with your favorite AI Agent harness.","skill_md_sha":"817acc1e3ecb0914687ce8c18ae4397d3c6515c8","skill_md_path":"skills/014-agile-user-story/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/jabrena/cursor-rules-java/tree/main/skills/014-agile-user-story"},"layout":"multi","source":"github","category":"cursor-rules-java","frontmatter":{"name":"014-agile-user-story","license":"Apache-2.0","description":"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. This should trigger for requests such as Create a user story; Write a user story; I need to write a user story. Part of cursor-rules-java project"},"skills_sh_url":"https://skills.sh/jabrena/cursor-rules-java/014-agile-user-story"},"updatedAt":"2026-04-26T18:53:39.692Z"}}