story-splitting

Identify and propose splits for large user stories using linguistic patterns and heuristics.

25|5|Updated May 1, 2026
One-click install
npx skills add https://github.com/josemerca/mercadona-user-story-toolkit --skill story-splitting-josemerca
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: story-splitting
Source: https://github.com/josemerca/mercadona-user-story-toolkit/tree/main/skills/story-splitting
Command: npx skills add https://github.com/josemerca/mercadona-user-story-toolkit --skill story-splitting-josemerca

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps identify and split large, complex user stories into smaller, more manageable pieces, improving collaboration and reducing risk in software development.

Core Features & Use Cases

  • Red Flag Detection: Identifies common linguistic patterns in stories that indicate they may be too large or complex.
  • Heuristic-Based Splitting: Applies a set of heuristics to suggest how to split stories into smaller, valuable increments.
  • Collaborative Process: Engages stakeholders in a collaborative process to refine and confirm splits.
  • Use Case: Ideal for teams working with user stories in Agile or Scrum methodologies, especially when stories are too large or complex to be effectively handled in a single iteration.

Quick Start

Run the command '/split-stories' on your story to get recommendations on how to split it into smaller, manageable pieces.

Frequently Asked Questions about story-splitting

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

FAQPage Schema
How do I split large user stories in Agile into smaller increments?

To split large user stories, this capability identifies red flags in story text and applies heuristic-based analysis to propose manageable, valuable increments for Agile development.

What are common linguistic red flags that indicate a user story is too large for a single iteration?

Common linguistic red flags in user stories, such as complex conjunctions or vague terminology, indicate a story is too large. This process detects these patterns to signal splitting is needed.

How do I use heuristics to break down complex Scrum stories?

You use heuristics to break down complex Scrum stories by running the split command on your story text. It then recommends splits and engages stakeholders to confirm the increments.

Does this story splitting process work for any user story format?

This story splitting process works specifically for software development user stories in Agile and Scrum environments. It requires analyzing story text to detect patterns and apply splitting heuristics.

What is the best way to refine large user stories collaboratively with stakeholders?

The best way to refine large user stories collaboratively is to generate heuristic-based split proposals first. Stakeholders then review these smaller, valuable increments to confirm the breakdown.

Why does my Agile user story seem too complex to estimate effectively?

An Agile user story seems too complex to estimate because it contains linguistic red flags indicating excessive scope. Heuristic analysis identifies these patterns to split the story into manageable pieces.