skills.rest
epieczko
epieczkoCOMMUNITY
Explore all skills by this author →
GitHub

epic.decompose

Parse Markdown Epic documents and generate structured user stories as JSON.

2|Updated Oct 22, 2025
Search Tags:#agile#product development#user stories#epic#decompose
One-click install
npx skills add https://github.com/epieczko/betty --skill epic-decompose
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: epic.decompose
Source: https://github.com/epieczko/betty/tree/main/skills/epic.decompose
Command: npx skills add https://github.com/epieczko/betty --skill epic-decompose

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill eliminates the time-consuming manual process of breaking down large product epics into manageable development tasks.

Core Features & Use Cases

  • Epic Analysis: Parse markdown epics to identify deliverables and personas.
  • Story Generation: Automatically create INVEST-compliant user stories with acceptance criteria.
  • Use Case: Take a product epic document and automatically generate 5 user stories with clear goals and benefits.

Quick Start

Decompose the epic document 'product_launch.md' into structured stories.

Frequently Asked Questions about epic.decompose

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

FAQPage Schema
How do I break down a large epic into user stories?▼

Decompose epics into user stories by parsing your Markdown epic document to extract deliverables, personas, and acceptance criteria, then automatically generate INVEST-compliant stories grouped by capability with clear goals and benefits.

Can I automatically generate user stories from a Markdown epic?▼

Yes. Provide a Markdown-formatted epic document and the Skill parses it to generate structured user stories with persona, goal, benefit, and acceptance criteria, outputting results as a JSON file for agile planning.

What's the best way to structure an epic for story decomposition?▼

Format your epic as Markdown with clear sections identifying deliverables and personas. The Skill extracts this structure to generate independent, testable user stories with associated acceptance criteria and benefits.

Does epic decomposition work with acceptance criteria extraction?▼

Yes. The Skill parses acceptance criteria from your epic document and applies them to each generated user story, ensuring stories are testable and meet functional requirements.

How many user stories can be generated from a single epic?▼

The Skill applies a configurable maximum story count to break down large epics into manageable tasks. Typical workflows generate 5+ independent stories per epic with clear goals and benefits.

Related Skills

Explore More Product & Management Skills→
epieczkoepieczko

story.write

Convert decomposed epic items into formatted user story Markdown files.

Community
Intermediate
camilooscargbaptistacamilooscargbaptista
7

sprint-planning

Convert backlog items into prioritized user stories with acceptance criteria and sprint backlog.

Community
Advanced
devCharuzudevCharuzu

agile-product-owner

Organize Agile backlog management and sprint execution with user stories and capacity planning.

Community
Advanced
deMGoncalvesdeMGoncalves
4

Orchestrator Skill

Decompose large specifications into atomic implementation tasks with dependencies and acceptance criteria.

Community
Advanced