user-stories

Convert approved PRDs into INVEST-compliant user stories with estimates and dependencies.

Updated May 5, 2026
One-click install
npx skills add https://github.com/shakhovskiya-create/shakhoff-claude-marketplace --skill user-stories-shakhovskiya-create
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: user-stories
Source: https://github.com/shakhovskiya-create/shakhoff-claude-marketplace/tree/main/plugins/solo-sdlc/skills/user-stories
Command: npx skills add https://github.com/shakhovskiya-create/shakhoff-claude-marketplace --skill user-stories-shakhovskiya-create

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps product teams convert approved PRDs into well-structured user stories that meet INVEST criteria, accelerating sprint planning and ensuring testable requirements.

Core Features & Use Cases

  • Generate INVEST-compliant user stories from a PRD, mapping features to personas and acceptance criteria.
  • Output stories to docs/user-stories/<feature>/stories.md with a standardized template, including estimates and dependencies.
  • Perform story splitting when epics arise, validate INVEST criteria, and deliver sprint-readiness recommendations.

Quick Start

Provide an approved PRD to generate INVEST-compliant user stories ready for sprint planning.

Frequently Asked Questions about user-stories

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

FAQPage Schema
How do I generate INVEST-compliant user stories from a PRD?

To generate INVEST-compliant user stories from a PRD, provide the approved PRD containing features and personas. The tool extracts personas and outputs stories mapping to acceptance criteria, estimates, and dependencies into a standardized markdown template.

How does story splitting work for large epics in sprint planning?

Story splitting for large epics occurs automatically when the tool detects them during PRD processing. It breaks down large epics into smaller, INVEST-compliant user stories to ensure they are testable and ready for sprint planning.

Do I need an approved PRD with specific personas to create user stories?

Yes, you need an approved PRD that explicitly includes features and personas. The tool relies on these inputs to extract personas and generate user stories that accurately map to acceptance criteria and dependencies.

Can I output user stories with acceptance criteria and estimates directly to a markdown file?

Yes, user stories with acceptance criteria and estimates are output directly to docs/user-stories/<feature>/stories.md. This standardized markdown file ensures consistent formatting for sprint planning and cross-cutting considerations.

What's the best way to prepare user stories for sprint planning from product requirements?

The best way to prepare user stories for sprint planning is converting approved product requirements into INVEST-compliant stories. This process validates criteria, generates estimates, identifies dependencies, and provides sprint-readiness recommendations.

Why do my generated user stories fail INVEST criteria during sprint planning?

User stories fail INVEST criteria when they are too large or lack clear acceptance criteria. This tool prevents failures by validating INVEST compliance during generation and applying story splitting to ensure testable, manageable outputs.