writing-user-stories — Claude Code skill: user story format
writing-user-stories — a skill that teaches agents to write user stories in standard format: persona, action, and benefit. Triggers when you need to define requirements from the user's perspective.
MIT 1 installs ★ 296 updated 2026-01-20
npx skills add nicepkg/ai-workflow --skill writing-user-stories -a claude-codeWhat writing-user-stories does
User stories break down requirements into three parts: who performs the action (persona), what they do (action), and why it matters (benefit). The format is formulaic: “As a PERSONA I want to DESCRIPTION_OF_ACTION So that DESCRIPTION_OF_BENEFIT”. This structure makes requirements clear and testable.
The skill runs on Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. Use it when planning features, refining requirements, or asking an agent to generate a set of stories for a project. An agent working from this skill focuses on user needs rather than just technical implementation.
Installation varies by platform. For Claude Code, run npx skills add nicepkg/ai-workflow --skill writing-user-stories -a claude-code. For GitHub Copilot, use gh skill install nicepkg/ai-workflow writing-user-stories. After setup, the skill loads into the agent's context and activates when you ask for user stories.
What it helps with
- Define requirements from a user's perspective instead of technical specs
- Generate user stories for a new feature or epic
- Ensure each story is clear enough to test and estimate
Example prompts for the agent
- Write user stories for an export-to-PDF feature
- Help me plan this feature using the writing-user-stories skill
- Convert this technical spec into a set of user stories
How to install writing-user-stories
1Skills CLI (Vercel)
npx skills add nicepkg/ai-workflow --skill writing-user-stories -a claude-code2Manually: put the files in place
~/.claude/skills/writing-user-stories/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/writing-user-stories/
1Skills CLI (Vercel)
npx skills add nicepkg/ai-workflow --skill writing-user-stories -a codex2Manually: put the files in place
.agents/skills/writing-user-stories/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add nicepkg/ai-workflow --skill writing-user-stories -a cursor2Manually: put the files in place
.cursor/skills/writing-user-stories/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install nicepkg/ai-workflow workflows/product-manager-workflow/.claude/skills/writing-user-stories2Manually: put the files in place
.github/skills/writing-user-stories/SKILL.md1Skills CLI (Vercel)
npx skills add nicepkg/ai-workflow --skill writing-user-stories -a gemini-cli2Platform CLI
gemini skills install https://github.com/nicepkg/ai-workflow --path workflows/product-manager-workflow/.claude/skills/writing-user-storiesManually: put the files in place
.devin/skills/writing-user-stories/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add nicepkg/ai-workflow --skill writing-user-stories -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about writing-user-stories
How do I install writing-user-stories in Claude Code?
Run npx skills add nicepkg/ai-workflow --skill writing-user-stories -a claude-code. The skill loads into ~/.claude/skills/writing-user-stories/SKILL.md and is available to your agent on the next run.
What does writing-user-stories do?
It teaches agents to write user stories in standard form: as a persona, I want to do X so that Y. This clarifies feature requirements and makes planning and estimation more straightforward.
Which platforms support writing-user-stories?
Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. Installation steps differ: use npx skills add for Claude Code and gh skill install for GitHub Copilot.
Source text
SKILL.md · MIT
--- name: writing-user-stories description: Use when an agent needs to write user stories for a project --- # Writing User Stories ## Overview Help Claude and subagents write properly formatted user stories for task definition. **Core principle:** User stories are formulaic ways of expressing user requirements. They identify the perosna of the actor, what they want to do, and what benefit are they hoping to gain from their actions. ## When to Use This Skill Use this skill when: - You are asked to write a user story - You are asked to plan a feature ## User Story Format As a PERSONA I want to DESCRIPTION_OF_ACTION So that DESCRIPTION_OF_BENEFIT. ### Examples As a non-technical stakeholder, I want to understand what changed in a release without reading code diffs so that I can communicate updates to customers effectively. As a new user, I want to see examples of AI-generated code before connecting my repository so that I understand the value proposition before committing to integration. As a home cook, I want to see that recipes have been tested by professional chefs so that I can know whether they are worth trying.
© nicepkg · MIT · nicepkg/ai-workflow