user-stories

Generate testable user stories with acceptance criteria for product features.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/omeragaakbas/zoyare --skill user-stories-omeragaakbas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: user-stories
Source: https://github.com/omeragaakbas/zoyare/tree/main/.claude/skills/user-stories
Command: npx skills add https://github.com/omeragaakbas/zoyare --skill user-stories-omeragaakbas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many product teams struggle to convert high-level features and designs into clear, independent, and testable backlog items, causing ambiguous requirements and slow delivery. This Skill standardizes user story creation so teams get consistent titles, conversations, and confirmations that are sprint-ready.

Core Features & Use Cases

  • 3 C's Structure: Produces Card (title), Conversation (intent & details), and Confirmation (acceptance criteria) for each story.
  • INVEST Compliance: Ensures stories are Independent, Negotiable, Valuable, Estimable, Small, and Testable.
  • Design-linked Acceptance Criteria: Embeds design links and contextual assumptions to make acceptance criteria actionable.
  • Use Cases: Breaking a new feature into sprint-sized backlog items, defining acceptance criteria for QA, and sizing stories for planning.

Quick Start

Create five independent user stories for the "Recently Viewed" feature in the Online Shopper product using the supplied Figma design link and assumptions.

Frequently Asked Questions about user-stories

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I break product features into ready-to-build user stories?

To break product features into ready-to-build user stories, apply the 3 C's structure to generate a clear title, conversation details, and confirmation acceptance criteria. This standardizes story creation into independent, testable backlog items.

What is the 3 C's structure for backlog items?

The 3 C's structure for backlog items organizes user stories into Card, Conversation, and Confirmation. Card provides the title, Conversation captures intent and details, and Confirmation defines the testable acceptance criteria.

How do I write acceptance criteria that QA can test?

To write acceptance criteria that QA can test, generate 4-6 specific confirmation statements per story. Embed design links and contextual assumptions to make each criterion actionable and independent for development and testing.

How do I ensure my user stories follow the INVEST criteria?

To ensure user stories follow the INVEST criteria, validate each backlog item for Independence, Negotiability, Value, Estimability, Size, and Testability. This guarantees stories are properly sized for sprint planning and delivery.

Can I use Figma design links when defining product requirements?

Yes, you can use Figma design links when defining product requirements. The generated user stories embed design links directly within the acceptance criteria to provide contextual assumptions for developers and testers.

What is the best way to size stories for a sprint?

The best way to size stories for a sprint is to break down high-level features into independent, estimable, and small items. Applying the INVEST criteria ensures each story is small enough for a single sprint iteration.