# task-breakdown

task-breakdown turns feature specifications into bite-sized TDD tasks with file paths and tests before any code gets touched.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 212 installs · ★ 4 repo stars
- Author: davidkiss
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davidkiss/smart-ai-skills/tree/HEAD/skills/task-breakdown/SKILL.md
- Updated: 2026-05-08
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/davidkiss-task-breakdown

## What it does

This skill instructs the agent to prepare a granular plan before writing code. It assumes the implementer lacks context on the codebase, so it documents exact file paths, lines to edit, and minimal code snippets. Every action takes 2 to 5 minutes, enforcing a strict TDD rhythm: write the failing test, run it, implement the fix, and confirm it passes.

The skill reviews the generated breakdown with a subagent grounded via web search. Tasks are then shown to you one by one based on dependencies, and confirmed items are appended to `docs/YYYY-MM-DD-<feature-name>-tasks.md`. Because critique relies on web search, the environment must provide a working search tool.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add davidkiss/smart-ai-skills --skill task-breakdown -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/task-breakdown/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/task-breakdown/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add davidkiss/smart-ai-skills --skill task-breakdown -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/task-breakdown/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add davidkiss/smart-ai-skills --skill task-breakdown -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/task-breakdown/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davidkiss/smart-ai-skills skills/task-breakdown
```

2. **Manually: put the files in place**
- File: `.github/skills/task-breakdown/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add davidkiss/smart-ai-skills --skill task-breakdown -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/davidkiss/smart-ai-skills --path skills/task-breakdown
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/task-breakdown/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add davidkiss/smart-ai-skills --skill task-breakdown -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davidkiss/smart-ai-skills/tree/HEAD/skills/task-breakdown/SKILL.md

## When to use it
- split large specs into 2-5 minute execution steps
- map out exact file paths and line edits in advance
- enforce test-driven development checks before coding
- store approved implementation plans in project documentation

## Example prompts
- Use task-breakdown to plan our payment gateway integration from specs.md
- Create a detailed task breakdown for adding user authentication
- Break down the new API endpoint requirements into small TDD steps

## Similar
- [Task Breakdown Specialist](https://affpapa.org/en/nevibecode/skills/task-breakdown-specialist.md) — skill · 149 installs
- [planning-and-task-breakdown](https://affpapa.org/en/nevibecode/skills/planning-and-task-breakdown.md) — skill · 80700 installs
- [absolute-work](https://affpapa.org/en/nevibecode/skills/absolute-work.md) — skill · 216 installs
- [plan-task](https://affpapa.org/en/nevibecode/skills/plan-task.md) — skill · 1300 installs
- [task-decomposition-expert](https://affpapa.org/en/nevibecode/agents/task-decomposition-expert.md) — subagent · 6870 installs
- [task-decomposer](https://affpapa.org/en/nevibecode/skills/task-decomposer.md) — skill · 155 installs

## Other versions with the same name
- [task-breakdown · jwynia](https://affpapa.org/en/nevibecode/skills/task-breakdown.md) — 507 installs
- [task-breakdown · centminmod](https://affpapa.org/en/nevibecode/skills/centminmod-task-breakdown.md) — ★ 2744 repo stars

From the same set: [davidkiss/smart-ai-skills](https://affpapa.org/en/nevibecode/by/davidkiss/smart-ai-skills.md) — 6 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
