Agent skill

Epic Breakdown Advisor

by deanpeters in deanpeters/Product-Manager-Skills

Splits a too-large epic into user stories using Richard Lawrence's nine Humanizing Work splitting patterns while keeping each story a vertical slice of user value.

Custom licenceAuto-check passedProduct & Project Management

Install Epic Breakdown Advisor

skills CLI
$ npx skills add deanpeters/Product-Manager-Skills --skill epic-breakdown-advisor -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install deanpeters/Product-Manager-Skills epic-breakdown-advisor --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/deanpeters/Product-Manager-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/epic-breakdown-advisor .claude/skills/epic-breakdown-advisor && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
epic-breakdown-advisor
GitHub stars
7.2k
Used in
1 other repo
Token cost
~6k tokens
SKILL.md length
2,760 words
Files
1
Skills in repo
75
Repo updated
First seen
Licence
Custom licence

At a glance

Splits a too-large epic into user stories using Richard Lawrence's nine Humanizing Work splitting patterns while keeping each story a vertical slice of user value.

  • Works in 4 steps: Provide Epic Context → Pre-Split Validation (INVEST Check) → Apply Splitting Patterns Sequentially → …
  • A backlog item is too large to estimate or deliver safely
  • SKILL.md covers Purpose, Input, Key Concepts and Application, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

The advisor first checks the story against the INVEST criteria, leaving out the Small test, then works through the nine splitting patterns in order until one fits, starting with workflow steps, operations (CRUD), business rule variations and data variations. Splits must be vertical slices that cross architectural layers and deliver observable user value, not horizontal slices such as a front-end story plus a back-end story.

Candidate splits are judged by what they reveal: the preferred split exposes low-value work you can drop or yields stories of similar size. You paste the epic as written in the backlog, optionally with sprint length, estimation ceiling and what blocks delivery. Starting with nothing also works, since the advisor asks for the epic text and then walks the pattern flowchart against it.

When your agent uses it

  • A backlog item is too large to estimate or deliver safely
  • Choosing between splitting by workflow step, operation or business rule
  • Replacing technical-layer stories with end-to-end slices

Example prompts

  • “Break this down: 'As a finance admin, I can export any report to Excel, PDF, or CSV with custom date ranges and saved templates.'”
  • “Split this epic so each story can ship within a single sprint.”
  • “Check whether our checkout story passes INVEST before we split it.”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Provide Epic Context
  2. Pre-Split Validation (INVEST Check)
  3. Apply Splitting Patterns Sequentially
  4. Evaluate Split Quality

What it can do on your machine

Read from SKILL.md and the folder at commit 1b5a524. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • humanizingwork.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Epic Breakdown Advisor loads about 6k tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 2,760 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 2,760 words (~6,019 tokens).

“Guide product managers through breaking down epics into user stories using Richard Lawrence's complete Humanizing Work methodology—a systematic, flowchart-driven approach that applies 9 splitting patterns sequentially. Use this to identify which pattern applies, split while preserving user value, and evaluate…”

— opening of SKILL.md by deanpeters, Custom licence
name
epic-breakdown-advisor
argument-hint
[epic to split]
intent
Guide product managers through breaking down epics into user stories using Richard Lawrence's complete Humanizing Work methodology—a systematic…
type
interactive
best_for
Splitting epics into smaller vertical slices, Choosing the right story split pattern for a large backlog item, Turning vague feature blobs into sprint-sized…
scenarios
Break this onboarding epic into smaller user stories, Help me split a large reporting feature before sprint planning, Which story-splitting pattern should I…
theme
pm-artifacts
estimated_time
20-30 min

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/epic-breakdown-advisor of deanpeters/Product-Manager-Skills.

Open the folder on GitHubat commit 1b5a524

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in deanpeters/Product-Manager-Skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Epic Breakdown Advisor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Epic Breakdown Advisor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Epic Breakdown Advisor this skilldeanpeters/Product-Manager-Skills7.2k1 repos~6kAutomated safety check: PassCustom licence
Agile Product Owneralirezarezvani/claude-skills28k3 repos~3.2kAutomated safety check: PassMIT
Project Planneradrianpuiu/claude-skills-marketplace1001 repos~6kAutomated safety check: PassNone
Backlog Builderopen-mercato/skills231—~3kAutomated safety check: NotesMIT
New FeaturePolymathWizard/BHIL-AI-First-Development-Toolkit132—~1.1kAutomated safety check: PassNone
Walking Skeleton Roadmap Scopingprime-radiant-inc/iterative-development181—~1.7kAutomated safety check: PassApache-2.0

Similar skills

  • Agile Product Owner

    alirezarezvani/claude-skills

    Writes INVEST-checked user stories with acceptance criteria, splits epics, plans sprints from velocity and ranks the backlog with a weighted score.

    28k GitHub starsUsed in 3 repos~3.2k tokens
    Product & Project ManagementAuto-check passed
  • Project Planner

    adrianpuiu/claude-skills-marketplace

    Comprehensive project planning and documentation generator for software projects.

    100 GitHub starsUsed in 1 repo~6k tokens
    Product & Project ManagementAuto-check passed
  • Backlog Builder

    open-mercato/skills

    Turns a product brief or a spec's phasing into a tracker backlog of epics, stories and tasks with stable ids, acceptance criteria and epic checklists.

    231 GitHub stars~3k tokensUpdated 3 days ago
    Product & Project ManagementAuto-check: notes
  • New Feature

    PolymathWizard/BHIL-AI-First-Development-Toolkit

    Create a complete feature artifact scaffold — PRD slice, technical spec, and task breakdown.

    132 GitHub stars~1.1k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed
  • Walking Skeleton Roadmap Scoping

    prime-radiant-inc/iterative-development

    Turns extracted requirements into a roadmap by choosing a walking skeleton iteration with its first journey scenario and ordering the remaining work into follow-on iterations.

    181 GitHub stars~1.7k tokensUpdated 4 mo ago
    Product & Project ManagementAuto-check passed
  • Manages GitHub issues and project boards with swarm coordination: issue creation and triage, issue-to-task conversion, progress tracking and stale issue cleanup.

    819 GitHub starsUsed in 6 repos~7.1k tokens
    Product & Project ManagementAuto-check passed

More from deanpeters/Product-Manager-Skills

All 75 skills in this repo
  • User Story Writer

    deanpeters/Product-Manager-Skills

    Writes user stories in Mike Cohn's format with Gherkin acceptance criteria, turning user needs into development-ready work with testable conditions.

    7.2k GitHub starsUsed in 2 repos~2.9k tokens
    Auto-check passed
  • TAM SAM SOM Calculator

    deanpeters/Product-Manager-Skills

    Calculates total, serviceable available and serviceable obtainable market size for a product idea with explicit assumptions, methods and caveats.

    7.2k GitHub starsUsed in 1 repo~4.8k tokens
    Auto-check passed
  • Organic Growth Path Advisor

    deanpeters/Product-Manager-Skills

    Diagnoses where a growth constraint lives and recommends one organic growth path from the McKinsey Growth Pyramid to test first.

    7.2k GitHub starsUsed in 2 repos~5.2k tokens
    Auto-check passed
  • Prioritization Framework Advisor

    deanpeters/Product-Manager-Skills

    Picks the right prioritization framework for your stage and context instead of defaulting to RICE or ICE out of habit.

    7.2k GitHub starsUsed in 2 repos~4.2k tokens
    Auto-check passed
  • Strategic Roadmap Planning

    deanpeters/Product-Manager-Skills

    Sequences prioritization, epic definition, and stakeholder alignment into a release plan that ladders up to business outcomes.

    7.2k GitHub starsUsed in 2 repos~4.7k tokens
    Auto-check passed
  • User Story Mapping

    deanpeters/Product-Manager-Skills

    Lays out a user journey as activities, steps, and tasks on a two-dimensional map that then informs backlog slicing.

    7.2k GitHub starsUsed in 2 repos~2.8k tokens
    Auto-check passed

Questions about Epic Breakdown Advisor

What does Epic Breakdown Advisor do?

Splits a too-large epic into user stories using Richard Lawrence's nine Humanizing Work splitting patterns while keeping each story a vertical slice of user value. The advisor first checks the story against the INVEST criteria, leaving out the Small test, then works through the nine splitting patterns in order until one fits, starting with workflow steps, operations (CRUD), business rule variations and data variations. Splits must be vertical slices that cross architectural layers and deliver observable user value, not horizontal slices such as a front-end story plus a back-end story.

When should I use Epic Breakdown Advisor?

Epic Breakdown Advisor fits situations like: A backlog item is too large to estimate or deliver safely; choosing between splitting by workflow step, operation or business rule; replacing technical-layer stories with end-to-end slices.

How do I install Epic Breakdown Advisor in Claude Code?

Run `npx skills add deanpeters/Product-Manager-Skills --skill epic-breakdown-advisor -a claude-code`. Or copy the skill folder (skills/epic-breakdown-advisor in deanpeters/Product-Manager-Skills) into .claude/skills/epic-breakdown-advisor in your project. Claude Code loads it when a task matches its description.

How do I install Epic Breakdown Advisor in Codex?

Run `npx skills add deanpeters/Product-Manager-Skills --skill epic-breakdown-advisor -a codex`. Or copy the skill folder (skills/epic-breakdown-advisor in deanpeters/Product-Manager-Skills) into .agents/skills/epic-breakdown-advisor in your project. Codex loads it when a task matches its description.

Can I use Epic Breakdown Advisor in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add deanpeters/Product-Manager-Skills --skill epic-breakdown-advisor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/epic-breakdown-advisor, .gemini/skills/epic-breakdown-advisor, .github/skills/epic-breakdown-advisor and .opencode/skills/epic-breakdown-advisor in your project.

What does Epic Breakdown Advisor need to run?

SKILL.md names no scripts, command-line tools or credentials: Epic Breakdown Advisor is instructions for the agent only.

Does Epic Breakdown Advisor access the network?

SKILL.md names 1 domain. As links in the text: humanizingwork.com. This is read from the text; nothing was executed.

Is Epic Breakdown Advisor safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Epic Breakdown Advisor use?

Epic Breakdown Advisor has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Epic Breakdown Advisor use?

About 6k tokens (SKILL.md is roughly 24k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Epic Breakdown Advisor?

Skills that share tags, products or a category with Epic Breakdown Advisor: Agile Product Owner (alirezarezvani/claude-skills, 28k stars), Project Planner (adrianpuiu/claude-skills-marketplace, 100 stars), Backlog Builder (open-mercato/skills, 231 stars) and New Feature (PolymathWizard/BHIL-AI-First-Development-Toolkit, 132 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Epic Breakdown Advisor?

deanpeters (a GitHub user) maintains it in deanpeters/Product-Manager-Skills, which has 7,209 GitHub stars. The repository holds 75 skills in this directory. The repository was last updated on September 1, 2026.

Source: deanpeters/Product-Manager-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.