user-story-writer

# User Story Writer Skill This skill produces production-ready user stories from a feature brief, PRD section, or verbal description. Each story follows the standard format with a clear who/what/why, behavioural acceptance criteria in Given/When/Then format, edge cases, and definition of done. Output is ready to paste into Jira, Linear, or your planning tool. ## Required Inputs Ask the user for these if not provided: - **Feature or change** to break into stories — paste the brief, PRD section, or describe the feature - **User types / personas** involved (e.g. admin, end user, guest, API consumer) - **Scope** — are we writing one story or decomposing an epic into a full set of stories? - **Acceptance criteria format preference** — Given/When/Then, bullet checklist, or both? - **Technical constraints or notes** — anything the engineering team has flagged that should shape the stories ## Output Structure For each story: --- ## Story: [Short title — verb + noun, e.g. "Filter search results by date range"] **Epic:** [Parent epic name — e.g. "Advanced Search"] **Story ID:** [Jira/Linear ID — leave blank if not yet created] **Priority:** [P1 / P2 / P3] **Story points:** [Leave blank — for engineering to estimate] --- ### User Story > **As a** [specific user type — not "user"], > **I want to** [concrete action they want to take], > **So that** [the outcome they achieve — business value, not feature description]. **Example:** > As an **account manager**, > I want to **filt...