{"id":"b6a5ca78-a806-4fc2-8c65-2a13d46bb936","shortId":"cREvDs","kind":"skill","title":"deliver-user-stories","tagline":"Generates user stories with clear acceptance criteria from product requirements or feature descriptions. Use when breaking down features for sprint planning, writing tickets, or communicating requirements to engineering.","description":"<!-- PM-Skills | https://github.com/product-on-purpose/pm-skills | Apache 2.0 -->\n# User Stories\n\nUser stories are concise descriptions of functionality from the user's perspective. They capture who needs something, what they need, and why . without prescribing how to build it. Good user stories enable teams to break large features into estimable, deliverable increments while maintaining focus on user value.\n\n## When to Use\n\n- After PRD approval, when breaking down features for implementation\n- During sprint planning to create actionable work items\n- When writing tickets for engineering teams\n- When communicating requirements to stakeholders in accessible terms\n- When prioritizing a backlog based on user value\n\n## Instructions\n\nWhen asked to create user stories, follow these steps:\n\n1. **Understand the Feature Context**\n   Review the PRD or feature description. Understand the overall goal, target users, and scope boundaries. User stories should trace back to documented requirements.\n\n2. **Identify User Personas**\n   Determine which users interact with this feature. Each story should be written for a specific persona, not generic \"users.\" Different personas may need different stories for the same feature.\n\n3. **Break Down by User Goal**\n   Decompose the feature into distinct user goals. Each story should deliver a complete, valuable capability . something the user can actually do when the story is done.\n\n4. **Write Story Statements**\n   Use the format: \"As a [persona], I want [action] so that [benefit].\" The benefit clause is critical . it explains why this matters and helps prioritize.\n\n5. **Define Acceptance Criteria**\n   Write specific, testable criteria using Given/When/Then format. Acceptance criteria define \"done\" . if all criteria pass, the story is complete.\n\n6. **Apply INVEST Criteria**\n   Validate each story against INVEST: Independent, Negotiable, Valuable, Estimable, Small, Testable. Revise stories that don't meet these criteria.\n\n7. **Add Context and Notes**\n   Include relevant design references, technical considerations, and dependencies. These help implementers understand the full picture.\n\n## Output Format\n\nUse the template in `references/TEMPLATE.md` to structure the output.\n\n## Quality Checklist\n\nBefore finalizing, verify:\n\n- [ ] Each story follows \"As a... I want... so that...\" format\n- [ ] Stories are independent (can be built in any order)\n- [ ] Acceptance criteria use Given/When/Then format\n- [ ] Each criterion is testable (someone can verify pass/fail)\n- [ ] Stories are small enough to complete in one sprint\n- [ ] No implementation details in the story statement\n- [ ] Benefit clause explains why this matters to the user\n\n## Examples\n\nSee `references/EXAMPLE.md` for a completed example.","tags":["deliver","user","stories","skills","product-on-purpose","agent-skills","ai-skills","claude-code","claude-desktop","openskills","product-management","skill-families"],"capabilities":["skill","source-product-on-purpose","skill-deliver-user-stories","topic-agent-skills","topic-ai-skills","topic-claude-code","topic-claude-desktop","topic-openskills","topic-product-management","topic-skill-families","topic-triple-diamond"],"categories":["pm-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/product-on-purpose/pm-skills/deliver-user-stories","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add product-on-purpose/pm-skills","source_repo":"https://github.com/product-on-purpose/pm-skills","install_from":"skills.sh"}},"qualityScore":"0.538","qualityRationale":"deterministic score 0.54 from registry signals: · indexed on github topic:agent-skills · 176 github stars · SKILL.md body (2,756 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-05-02T12:54:11.457Z","embedding":null,"createdAt":"2026-04-18T22:09:12.453Z","updatedAt":"2026-05-02T12:54:11.457Z","lastSeenAt":"2026-05-02T12:54:11.457Z","tsv":"'1':134 '2':162 '3':195 '4':227 '5':256 '6':279 '7':302 'accept':10,258,267,357 'access':114 'action':99,239 'actual':220 'add':303 'appli':280 'approv':87 'ask':126 'back':158 'backlog':119 'base':120 'benefit':242,244,386 'boundari':153 'break':20,69,89,196 'build':61 'built':353 'capabl':215 'captur':48 'checklist':334 'claus':245,387 'clear':9 'communic':29,109 'complet':213,278,375,400 'concis':38 'consider':312 'context':138,304 'creat':98,128 'criteria':11,259,263,268,273,282,301,358 'criterion':363 'critic':247 'decompos':201 'defin':257,269 'deliv':2,211 'deliver':74 'deliver-user-stori':1 'depend':314 'descript':17,39,144 'design':309 'detail':381 'determin':166 'differ':185,189 'distinct':205 'document':160 'done':226,270 'enabl':66 'engin':32,106 'enough':373 'estim':73,291 'exampl':395,401 'explain':249,388 'featur':16,22,71,91,137,143,172,194,203 'final':336 'focus':78 'follow':131,340 'format':233,266,323,347,361 'full':320 'function':41 'generat':5 'generic':183 'given/when/then':265,360 'goal':148,200,207 'good':63 'help':254,316 'identifi':163 'implement':93,317,380 'includ':307 'increment':75 'independ':288,350 'instruct':124 'interact':169 'invest':281,287 'item':101 'larg':70 'maintain':77 'matter':252,391 'may':187 'meet':299 'need':50,54,188 'negoti':289 'note':306 'one':377 'order':356 'output':322,332 'overal':147 'pass':274 'pass/fail':369 'persona':165,181,186,236 'perspect':46 'pictur':321 'plan':25,96 'prd':86,141 'prescrib':58 'priorit':117,255 'product':13 'qualiti':333 'refer':310 'references/example.md':397 'references/template.md':328 'relev':308 'requir':14,30,110,161 'review':139 'revis':294 'scope':152 'see':396 'skill' 'skill-deliver-user-stories' 'small':292,372 'someon':366 'someth':51,216 'source-product-on-purpose' 'specif':180,261 'sprint':24,95,378 'stakehold':112 'statement':230,385 'step':133 'stori':4,7,34,36,65,130,155,174,190,209,224,229,276,285,295,339,348,370,384 'structur':330 'target':149 'team':67,107 'technic':311 'templat':326 'term':115 'testabl':262,293,365 'ticket':27,104 'topic-agent-skills' 'topic-ai-skills' 'topic-claude-code' 'topic-claude-desktop' 'topic-openskills' 'topic-product-management' 'topic-skill-families' 'topic-triple-diamond' 'trace':157 'understand':135,145,318 'use':18,84,231,264,324,359 'user':3,6,33,35,44,64,80,122,129,150,154,164,168,184,199,206,218,394 'valid':283 'valu':81,123 'valuabl':214,290 'verifi':337,368 'want':238,344 'without':57 'work':100 'write':26,103,228,260 'written':177","prices":[{"id":"bcb78f81-2de7-4546-bdbb-451ab958938d","listingId":"b6a5ca78-a806-4fc2-8c65-2a13d46bb936","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"product-on-purpose","category":"pm-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T22:09:12.453Z"}],"sources":[{"listingId":"b6a5ca78-a806-4fc2-8c65-2a13d46bb936","source":"github","sourceId":"product-on-purpose/pm-skills/deliver-user-stories","sourceUrl":"https://github.com/product-on-purpose/pm-skills/tree/main/skills/deliver-user-stories","isPrimary":false,"firstSeenAt":"2026-04-18T22:09:12.453Z","lastSeenAt":"2026-05-02T12:54:11.457Z"}],"details":{"listingId":"b6a5ca78-a806-4fc2-8c65-2a13d46bb936","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"product-on-purpose","slug":"deliver-user-stories","github":{"repo":"product-on-purpose/pm-skills","stars":176,"topics":["agent-skills","ai-skills","claude-code","claude-desktop","openskills","product-management","skill-families","triple-diamond"],"license":"apache-2.0","html_url":"https://github.com/product-on-purpose/pm-skills","pushed_at":"2026-04-24T22:54:13Z","description":"Curated, plug-and-play product management skills for AI agents. 38 skills across Triple Diamond phases plus foundation (lean canvas, persona, meeting lifecycle family) and utility (create, validate, iterate). Templates, workflows, thread-aligned samples, CI-enforced skill-family contracts. Apache 2.0.","skill_md_sha":"2880b76f12bf6410b00cbf03e976d4e8c8db0f05","skill_md_path":"skills/deliver-user-stories/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/product-on-purpose/pm-skills/tree/main/skills/deliver-user-stories"},"layout":"multi","source":"github","category":"pm-skills","frontmatter":{"name":"deliver-user-stories","license":"Apache-2.0","description":"Generates user stories with clear acceptance criteria from product requirements or feature descriptions. Use when breaking down features for sprint planning, writing tickets, or communicating requirements to engineering."},"skills_sh_url":"https://skills.sh/product-on-purpose/pm-skills/deliver-user-stories"},"updatedAt":"2026-05-02T12:54:11.457Z"}}