LogoAwesome Skills
  • Search
  • Category
  • Tag
  • Blog
LogoAwesome Skills
LogoAwesome Skills

Discover Open-Source Agent Skills for AI Coding Assistants

Product

  • Search
  • Category
  • Tag
  • Blog

Resources

  • Claude Skill Docs
  • Antigravity Skills Docs

Tools

  • Claude Code
  • OpenCode
  • Cursor
  • Codex
  • Antigravity

Company

  • Privacy Policy
  • Terms of Service
  • Sitemap

©2026 Awesome Skills. All rights reserved.

Privacy PolicyTerms
Back to Skills

user-story-splitting

Break a large story or epic into smaller deliverable stories using proven split patterns. Use when backlog items are too big for estimation, sequencing, or independent release.

5,807stars714forksUpdated 7/17/2026
#story-splitting#backlog#user-stories#product-management#agile

Security Assessment

Safe(100/100)
Security Score100/100

About user-story-splitting

user-story-splitting breaks a large user story, epic, or feature into smaller, independently deliverable stories using proven split patterns. It is used when backlog items are too big for estimation, sequencing, or independent release, with the goal of making work more manageable, reducing risk, enabling faster feedback cycles, and maintaining flow in agile development. The skill frames this as strategic decomposition that preserves user value, not arbitrary slicing, and applies to any work too large to complete in a single sprint.

The method is based on Richard Lawrence and Peter Green's Humanizing Work Guide to Splitting User Stories, which provides eight systematic patterns worked through in order until one applies: Workflow steps, Business rule variations, Data variations, Acceptance criteria complexity (multiple When or Then statements, noted as the most common indicator), Major effort, External dependencies, DevOps steps, and Tiny Acts of Discovery (TADs) for unpacking unknowns when nothing else fits. The skill takes the story or epic as input (works best with the story pasted as written, plus why it is too big and the team's sizing ceiling; anything supplied inline counts as already-answered context). It applies the splitting logic step by step, using template.md for the full fill-in structure and output format, and includes worked examples for each pattern such as splitting sign-up/verify/onboarding into workflow steps or discount tiers into business rule variations.

The skill targets product managers and agile teams and is explicit about anti-patterns: it is not horizontal slicing into front-end and back-end stories, not task decomposition (stories are not tasks like set up database or write API), and not arbitrary chopping into meaningless fragments. It also lists when not to use it, such as when a story is already small and well-scoped, when splitting would create delivery-slowing dependencies, or when the item is a technical task better handled by engineering task breakdown. Documented in SKILL.md with a template.md and a sample example, it references companion user-story and epic-hypothesis skills for formatting inputs.

FAQ

What are the eight splitting patterns?

Workflow steps, Business rule variations, Data variations, Acceptance criteria complexity, Major effort, External dependencies, DevOps steps, and Tiny Acts of Discovery (TADs). They are worked through in order, stopping at the first that applies; multiple When/Then pairs in acceptance criteria are noted as the most common indicator.

When should I use this skill?

When a story is too large for a single sprint, when acceptance criteria have multiple When or Then statements, when an epic needs breaking into deliverable increments, when the team can't agree on story size, or when a story bundles multiple personas or workflows.

When should I NOT use it?

When a story is already small and well-scoped (avoid over-splitting), when splitting would create dependencies that slow delivery, or when the item is a technical task better handled by engineering task breakdown.

What are the anti-patterns it warns against?

Not horizontal slicing into separate front-end and back-end stories, not task decomposition (stories are not tasks like set up database or write API), and not arbitrary chopping into meaningless fragments. Each split story should still deliver user value.

What input works best and what framework is it based on?

It works best with the too-big story pasted as written, plus why it's too big and the team's sizing ceiling; inline arguments count as already-provided context. It is based on Richard Lawrence and Peter Green's Humanizing Work Guide to Splitting User Stories, and uses template.md for the fill-in output structure.

All Files

3 files
SKILL.md12.1 KB
View
template.md1.1 KB
View
examples/sample.md3.5 KB
View

Install user-story-splitting

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill

Repository

deanpeters/product-manager-skills

Related Skills

threat-modeling-with-aws-security-agent

2,903

amazon-workspaces-agent-access

2,903

build-loop-codex

230

developing-ios-apps

1,477