skills.rest
matteocervelli
matteocervelliCOMMUNITY
Explore all skills by this author →
Website𝕏@matteocervelliGitHub

user-story-generator

Convert feature descriptions into INVEST-compliant user stories with YAML and Markdown exports.

25|2|Updated Oct 26, 2025
Search Tags:#automation#workflow#yaml#invest#story-generation# backlog
One-click install
npx skills add https://github.com/matteocervelli/llms --skill user-story-generator
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: user-story-generator
Source: https://github.com/matteocervelli/llms/tree/main/user-story-system/.claude/skills/user-story-generator
Command: npx skills add https://github.com/matteocervelli/llms --skill user-story-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, jinja2, pydantic, and includes scripts (resource) components.

What problem does it solve?

This orchestrator generates user stories from feature descriptions through interactive Q&A, INVEST validation, and automatic YAML/Markdown creation.

Core Features & Use Cases

  • Interactive feature extraction and validation
  • Intelligent story decomposition into 2-8 INVEST-aligned stories
  • Generate YAML and Markdown outputs
  • Optional GitHub integration and automation

Quick Start

Provide a feature description and let the generator produce a set of INVEST-aligned user stories with IDs US-XXXX.

Frequently Asked Questions about user-story-generator

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

FAQPage Schema
How do I convert feature descriptions into INVEST-compliant user stories?▼

User story generation decomposes feature descriptions into 2-8 INVEST-aligned stories through interactive Q&A. The Skill validates each story against INVEST criteria, assigns unique IDs (US-XXXX), and exports structured YAML and Markdown artifacts automatically.

What is INVEST and why does it matter for user stories?▼

INVEST is a checklist ensuring user stories are Independent, Negotiable, Valuable, Estimable, Small, and Testable. This Skill validates stories against these criteria during decomposition, reducing backlog quality issues and improving sprint planning accuracy.

Can I automate story generation and push results to GitHub?▼

Yes. The Skill includes optional GitHub integration, letting you generate stories and export them as pull requests or commits directly. YAML and Markdown outputs are templated for seamless version control workflows.

Do I need coding experience to generate user stories with this Skill?▼

No. The Skill uses interactive Q&A to extract features and decompose them into stories. You provide a feature description; it handles INVEST validation, technical annotation, and artifact generation without requiring code.

What output formats does the story generator produce?▼

The Skill generates YAML and Markdown outputs with templated rendering. Stories include unique IDs, INVEST compliance metadata, and technical annotations. Both formats support export to backlog tools or GitHub.

How does the Skill handle complex features with multiple dependencies?▼

The workflow decomposes features into 2-8 independent stories through phase-based processing: feature extraction, intelligent decomposition, INVEST validation, and technical annotation. Parallel processing handles multiple stories efficiently.

Related Skills

Explore More Product & Management Skills→
hheydaroffhheydaroff

prd-to-spec

Convert PRD.md documents into structured SPEC.md specifications with user stories and tasks.

Community
Intermediate
aj-geddesaj-geddes
472

Scrum Master

Automate sprint planning and backlog management with YAML-based templates.

Community
Basic
act70255act70255

pydantic-models-py

Generate Pydantic Base, Create, Update, Response, and InDB models.

Community
Intermediate
foomakersfoomakers
6

plan-stories

Break down epics into user stories with vertical slicing and INVEST validation.

Official
Advanced