메뉴
Use when someone needs to write a single user story or a small set of stories — translating a known user need into a structured, development-ready format with acceptance criteria. Triggers on: "write a user story", "user story format", "acceptance
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/newkayak12/claude-skills --skill user-story명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
SKILL.md 표시 중
SOC 직업 분류 기준
| name | user-story |
| effort | high |
| description | Use when someone needs to write a single user story or a small set of stories — translating a known user need into a structured, development-ready format with acceptance criteria. Triggers on: "write a user story", "user story format", "acceptance |
| type | component |
| theme | pm-artifacts |
| scenarios | ["I need to write a user story for a new notification system in our B2B SaaS app","Convert this PRD requirement into a properly formatted user story with Gherkin acceptance criteria","Write me a user story with Given/When/Then criteria for the checkout flow","유저 스토리 포맷으로 이 기능 요건을 변환해줘","인수 조건이 포함된 사용자 스토리 작성해줘"] |
| estimated_time | 5-10 min |
| compatibility | {"recommended":[],"optional":["think-tool"],"remote_mcp_note":"think-tool이 있으면 완성된 스토리의 INVEST 기준 검증 품질이 높아집니다. Claude 설정 → MCP Servers에서 remote SSE 엔드포인트를 추가하세요."} |
Use when:
Not for:
| Claude | You |
|---|---|
| Drafts As a / I want / So that structure | Validates persona accuracy against real users |
| Writes Given/When/Then acceptance criteria | Confirms testability with QA |
| Flags anti-patterns (task-style, vague, too large) | Decides on story scope and priority |
| Validates against INVEST criteria | Signs off the story before it enters the sprint |
../user-story-splitting/SKILL.md — split stories that fail the "Small" INVEST check../user-story-mapping/SKILL.md — generate a full story map first, then author individual stories../prd-development/SKILL.md — PRD requirements decompose into user storiesA user story combines:
Use Case (Mike Cohn format):
Acceptance Criteria (Gherkin format):
skills/user-story-splitting/SKILL.md)Before writing a story, ensure you have:
skills/proto-persona/SKILL.md)skills/problem-statement/SKILL.md)If missing context: Run discovery interviews or problem validation work first.
If you want a consistent Markdown stub, you can generate one from CLI inputs. This script is deterministic and does not fetch data or write files.
python3 scripts/user-story-template.py --persona \"trial user\" --action \"log in with Google\" --outcome \"access the app without creating a new password\"
Use template.md for the full fill-in structure. Fill in the Use Case section with As a / I want to / so that fields.
Quality checks:
Common mistakes:
Use template.md for the full fill-in structure. Fill in the Acceptance Criteria section with Scenario / Given / When / Then fields.
Quality checks:
Red flags:
skills/user-story-splitting/SKILL.md)Write a short, memorable summary that captures the story's value:
Examples:
If think-tool is available, invoke it now to review the completed story against these three criteria:
When and one Then in the acceptance criteriaAs a persona is more specific than "user" or "customer"Then clause is independently falsifiable and does not restate the When clauseThe think-tool should output PASS or FLAG with a one-sentence reason for each flagged criterion.
skills/user-story-splitting/SKILL.mdSee examples/sample.md for full examples (good, bad, and split-needed stories).
For detailed pitfall diagnosis and fixes, see references/pitfalls.md.
skills/user-story-splitting/SKILL.md — How to break large stories into smaller onesskills/proto-persona/SKILL.md — Defines the "As a [persona]" sectionskills/problem-statement/SKILL.md — Stories should address validated problemsskills/epic-hypothesis/SKILL.md — Epics decompose into user storiesskills/user-story/scripts/user-story-template.py — Deterministic Markdown stub generator (no network access)prompts/user-story-prompt-template.md in the https://github.com/deanpeters/product-manager-prompts repo.