user-stories

phuryn/pm-skills · updated Apr 8, 2026

$npx skills add https://github.com/phuryn/pm-skills --skill user-stories
0 commentsdiscussion
summary

Create user stories following the 3 C's (Card, Conversation, Confirmation) and INVEST criteria. Generates stories with descriptions, design links, and acceptance criteria.

skill.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

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.635 reviews
  • Hiroshi Flores· Dec 24, 2024

    user-stories is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.

  • Shikha Mishra· Dec 20, 2024

    user-stories reduced setup friction for our internal harness; good balance of opinion and flexibility.

  • Kwame Abebe· Dec 16, 2024

    user-stories has been reliable in day-to-day use. Documentation quality is above average for community skills.

  • Valentina Dixit· Dec 8, 2024

    Registry listing for user-stories matched our evaluation — installs cleanly and behaves as described in the markdown.

  • Sakura Robinson· Dec 4, 2024

    Solid pick for teams standardizing on skills: user-stories is focused, and the summary matches what you get after install.

  • Mateo Perez· Nov 27, 2024

    Useful defaults in user-stories — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

  • Aarav Malhotra· Nov 15, 2024

    user-stories fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.

  • Yash Thakker· Nov 11, 2024

    I recommend user-stories for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • Ama Srinivasan· Oct 18, 2024

    I recommend user-stories for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • Anaya Sanchez· Oct 6, 2024

    We added user-stories from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

showing 1-10 of 35

1 / 4