user-stories
This Claude Code skill generates structured user stories by applying the 3 C's framework (Card, Conversation, Confirmation) and INVEST criteria to break down product features. Use it when decomposing features into backlog items, defining acceptance criteria, or writing user stories that include descriptions, design references, and testable acceptance conditions.
git clone --depth 1 https://github.com/phuryn/pm-skills /tmp/user-stories && cp -r /tmp/user-stories/pm-execution/skills/user-stories ~/.claude/skills/user-storiesSKILL.md
# User Stories Create user stories following the 3 C's (Card, Conversation, Confirmation) and INVEST criteria. Generates stories with descriptions, design links, and acceptance criteria. **Use when:** Writing user stories, breaking down features into stories, creating backlog items, or defining acceptance criteria. **Arguments:** - `$PRODUCT`: The product or system name - `$FEATURE`: The new feature to break into stories - `$DESIGN`: Link to design files (Figma, Miro, etc.) - `$ASSUMPTIONS`: Key assumptions or context ## Step-by-Step Process 1. **Analyze the feature** based on provided design and context 2. **Identify user roles** and distinct user journeys 3. **Apply 3 C's framework:** - Card: Simple title and one-liner - Conversation: Detailed discussion of intent - Confirmation: Clear acceptance criteria 4. **Respect INVEST criteria:** Independent, Negotiable, Valuable, Estimable, Small, Testable 5. **Use plain language** a primary school graduate can understand 6. **Link to design files** for visual reference 7. **Output user stories** in structured format ## Story Template **Title:** [Feature name] **Description:** As a [user role], I want to [action], so that [benefit]. **Design:** [Link to design files] **Acceptance Criteria:** 1. [Clear, testable criterion] 2. [Observable behavior] 3. [System validates correctly] 4. [Edge case handling] 5. [Performance or accessibility consideration] 6. [Integration point] ## Example User Story **Title:** Recently Viewed Section **Description:** As an Online Shopper, I want to see a 'Recently viewed' section on the product page to easily revisit items I considered. **Design:** [Figma link] **Acceptance Criteria:** 1. The 'Recently viewed' section is displayed at the bottom of the product page for every user who has previously viewed at least 1 product. 2. It is not displayed for users visiting the first product page of their session. 3. The current product itself is excluded from the displayed items. 4. The section showcases product cards or thumbnails with images, titles, and prices. 5. Each product card indicates when it was viewed (e.g., 'Viewed 5 minutes ago'). 6. Clicking on a product card leads the user to the corresponding product page. ## Output Deliverables - Complete set of user stories for the feature - Each story includes title, description, design link, and 4-6 acceptance criteria - Stories are independent and can be developed in any order - Stories are sized for one sprint cycle - Stories reference related design documentation --- ### Further Reading - [How to Write User Stories: The Ultimate Guide](https://www.productcompass.pm/p/how-to-write-user-stories)
Analyze A/B test results with statistical significance, sample size validation, confidence intervals, and ship/extend/stop recommendations. Use when evaluating experiment results, checking if a test reached significance, interpreting split test data, or deciding whether to ship a variant.
Analyze and prioritize a list of feature requests by theme, strategic alignment, impact, effort, and risk. Use when reviewing customer feature requests, triaging a backlog, or making prioritization decisions.
Generate an Ansoff Matrix analysis mapping growth strategies across market penetration, market development, product development, and diversification. Use when considering growth options, planning market expansion, or evaluating strategic growth paths.
Identify the first beachhead market segment for a product launch. Evaluates segments against burning pain, willingness to pay, winnable market share, and referral potential. Use when choosing a first market, targeting an initial customer segment, or planning market entry strategy.
Design experiments to test assumptions for an existing product — prototypes, A/B tests, spikes, and other low-effort validation methods. Use when validating assumptions, testing feature ideas cheaply, or planning product experiments.
Design lean startup experiments (pretotypes) for a new product. Creates XYZ hypotheses and suggests low-effort validation methods like landing pages, explainer videos, and pre-orders. Use when validating a new product idea, creating pretotypes, or testing market demand.
Brainstorm product ideas for an existing product using multi-perspective ideation from PM, Designer, and Engineer viewpoints. Use when generating new feature ideas, brainstorming solutions for an identified opportunity, or ideating with a product trio.
Brainstorm feature ideas for a new product in initial discovery from PM, Designer, and Engineer perspectives. Use when starting product discovery for a new product, exploring features for a startup idea, or doing initial ideation.