task-breakdown

Analyzes a drafted ticket and decides whether it becomes one ticket or a multi-task mission.

Updated Jul 19, 2026
One-click install
npx skills add https://github.com/forhas/pure-dev --skill task-breakdown-forhas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: task-breakdown
Source: https://github.com/forhas/pure-dev/tree/main/plugins/notion-dev/skills/task-breakdown
Command: npx skills add https://github.com/forhas/pure-dev --skill task-breakdown-forhas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When turning an interviewed feature request into tickets, it is hard to decide whether the work should stay as a single ticket or be split into an Epic with phased, dependent tasks. This Skill applies consistent structural heuristics to make that call and produce a ready-to-use creation plan. ## Core Features & Use Cases - Single vs. mission decision: Returns a discriminated-union result (single or mission) based on deliverable count, blocking dependencies, file scope, and domain spread. - Structural tagging: Populates Epic, Phase, Step, and DependsOn fields only when the mission genuinely warrants them, omitting fields that do not apply. - Self-contained task bodies: Carves Requirements and Acceptance Criteria per task, copies Context and Source to every task, and distributes Open Questions to the tasks they affect. - Use Case: After /notion-dev:ticket-interviewer drafts a request like "Add Litecoin support", the Skill returns a mission with an Epic name and four phased tasks with explicit dependencies, which /notion-dev:create-task then creates. ## Quick Start Ask the assistant to run task-breakdown on the drafted ticket from the interviewer to decide whether it should be one ticket or a multi-task mission.

Frequently Asked Questions about task-breakdown

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

FAQPage Schema
How do I decide whether to split a feature request into multiple tickets?

Split only when the work has at least three independently deliverable units, explicit blocking dependencies between units, more than eight affected files, or substantially different domains. Otherwise keep it as one ticket, since multiple bullets or sections alone are not sufficient reason to split.

How to structure an epic with phases, steps, and dependencies?

Add Phase only when tasks group into sequential stages like Research then Implementation then Validation. Add Step only when two or more sibling tasks share a Phase and order matters, and DependsOn only for true blocking dependencies between sibling tasks.

Does task-breakdown create tickets in Notion or other backends?

No, it is backend-agnostic and performs structural analysis only. It does no I/O, reads no configuration, and calls no adapters; its output plan is consumed by the caller, such as /notion-dev:create-task, which handles actual creation.

When should I not split a ticket into a mission?

Do not split just because the source has multiple bullets, the database supports epics and phases, several files are involved, or tests and docs could be listed separately. Fewer, richer tasks are preferred over many shallow ones.

What input does the task-breakdown skill require?

It expects a JSON object with a title, a markdown body containing Requirements, Acceptance Criteria, Context, Open Questions, and Source sections, a sourceRef string, and an optional type of Feature, Bug, Improvement, or Research.