user-stories

Create and validate User Stories using 3C and INVEST criteria.

Updated Jun 28, 2026
One-click install
npx skills add https://github.com/jason23452/my-skill --skill user-stories-jason23452
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: user-stories
Source: https://github.com/jason23452/my-skill/tree/main/flow/user-stories
Command: npx skills add https://github.com/jason23452/my-skill --skill user-stories-jason23452

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning raw requirements into well-formed, testable User Stories is error-prone: stories often lack acceptance criteria, traceability, or clear scope boundaries. This Skill enforces a consistent structure so every story is reviewable and ready for development. ## Core Features & Use Cases - 3C and INVEST validation: Checks every story for Card, Conversation, Confirmation completeness and Independence, Negotiability, Value, Estimability, Smallness, and Testability. - Structured batch template: Generates stories with scope, non-goals, preconditions, business rules, data/audit impact, Given/When/Then acceptance criteria, assumptions, and traceability to source requirements. - Batch quality gate: Ensures a production-coverage map assigns each requirement dimension to a story before preview. - Use Case: Given a requirements document or wiki page, produce a batch of User Stories each with at least three acceptance scenarios and full source traceability. ## Quick Start Convert the attached requirements document into a batch of User Stories with acceptance criteria and traceability.

Frequently Asked Questions about user-stories

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

FAQPage Schema
How do I write User Stories from requirements?▼

Decompose the requirements document into one story per coherent product slice, each with a Card statement, Conversation notes, and Confirmation acceptance criteria. Preserve the source requirement id and path for traceability.

What is the INVEST criteria for User Stories?▼

INVEST checks that each story is Independent, Negotiable, Valuable, Estimable, Small, and Testable. A story passes when it can be planned alone, describes outcomes not implementation, and has observable pass/fail acceptance criteria.

How many acceptance criteria should a User Story have?▼

This Skill requires at least three Given/When/Then scenarios: a happy path, a validation/permission/boundary path, and a state/failure/recovery or audit path. Add more for empty, error, or conflict states when the workflow requires them.

When should I use job stories instead of User Stories?▼

Use job stories when the situation and trigger matter more than the actor, such as event-driven workflows. Use the standard 'As a [actor]' format when user role and permissions drive the behavior.

What are common User Story quality problems?▼

Common issues include sequence-only titles like 'US-01', missing non-goals, untestable acceptance criteria, and stories that bundle multiple product slices. The batch quality gate rejects stories lacking scope, traceability, or coverage of requirement dimensions.