Skip to main content
skill CX Codex

user-story-splitting — Claude Code skill: what it does, how to install

This skill breaks large user stories and epics into smaller stories that can be delivered independently. Use it when an item is hard to estimate or finish in a sprint.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add deanpeters/Product-Manager-Skills --skill user-story-splitting -a claude-code
Open on GitHub

What user-story-splitting does

The skill examines a story or epic and suggests split points based on workflow steps, business rules, data types, acceptance criteria, major effort, external dependencies, or DevOps work. If those patterns do not fit, it suggests small experiments to explore unknowns. Each resulting story is meant to retain user value.

Provide the story text, and optionally explain why it is hard to estimate or complete in a sprint and what size limit your team uses. The skill checks its patterns in order and stops when one applies; template.md supplies the full output structure. It is not intended for technical tasks: the source recommends using engineering task breakdown for those.

What it helps with

  • split an epic into deliverable increments
  • separate stories with multiple acceptance criteria
  • find story boundaries across workflow steps
  • make an oversized story easier to estimate
  • separate business-rule scenarios into distinct stories

Example prompts for the agent

  • Split this story into parts that can be released independently: “As a user, I want to…”
  • Break down this epic; we can’t finish it in a sprint.
  • Split this story by its business-rule scenarios while keeping value in each part.

How to install user-story-splitting

1Skills CLI (Vercel)

npx skills add deanpeters/Product-Manager-Skills --skill user-story-splitting -a claude-code

2Manually: put the files in place

~/.claude/skills/user-story-splitting/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/user-story-splitting/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about user-story-splitting

How do I install user-story-splitting in Claude Code?

Run npx skills add deanpeters/Product-Manager-Skills --skill user-story-splitting -a claude-code. The skill file is at ~/.claude/skills/user-story-splitting/SKILL.md.

What does user-story-splitting do?

It examines a large user story or epic and proposes smaller stories that can be delivered independently. It checks patterns such as workflow steps, business rules, data variations, and acceptance criteria.

Can I use the skill to break down a technical task?

The skill is for user stories, epics, and features. For technical tasks, the source recommends engineering task breakdown instead.

Similar skills

Everything for Notes, tasks and projects →

From the same set69

altitude-horizon-framework A reference skill that separates Director thinking from PM thinking on two axes: how wide you zoom out, how far ahead you look. Useful when the title changed and the work still feels like the old job. CX Codex +1 2,600installs problem-framing-canvas Guides teams through the MITRE problem framing model to clarify messy assumptions before writing code. Designed for 30–45 minute interactive sessions. CX Codex +1 2,600installs finance-metrics-quickref A quick SaaS finance reference for metric definitions, formulas, benchmarks and decision context during analysis. CX Codex +1 2,600installs positioning-workshop Runs a guided interview about target users, unmet needs, and competitors. Produces a Geoffrey Moore positioning statement in 60 to 90 minutes. CX Codex +1 2,500installs storyboard This skill drafts a six-frame storyboard tracing one person from a problem to its fix. Handy before a concept review or a demo. CX Codex +1 2,500installs positioning-statement Drafts a Geoffrey Moore positioning framework for your product. Helps pinpoint target buyers and sharp competitive differentiation. CX Codex +1 2,500installs executive-onboarding-playbook Helps a new VP or CPO map the first 90 days around organizational diagnosis, validation, and evidence-based decisions. Useful before changing teams or strategy. CX Codex +1 2,500installs saas-revenue-growth-metrics Calculates and explains SaaS revenue, retention, and growth metrics. Use it to investigate churn, expansion, and product-market-fit signals. CX Codex +1 2,400installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor