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

Work from what is given. If any of these is missing, still produce the complete output: fill each gap with a reasonable assumption marked (assumed, confirm) and list those assumptions at the end. Ask a question first only when the core subject itself is missing (there is nothing to write about).

• 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: