task-breakdown · davidkiss — Claude Code skill: what it does, how to install
task-breakdown turns feature specifications into bite-sized TDD tasks with file paths and tests before any code gets touched.
no license 212 installs ★ 4 updated 2026-05-08
npx skills add davidkiss/smart-ai-skills --skill task-breakdown -a claude-codeWhat task-breakdown 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.
What it helps with
- 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 for the agent
- 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
How to install task-breakdown
1Skills CLI (Vercel)
npx skills add davidkiss/smart-ai-skills --skill task-breakdown -a claude-code2Manually: put the files in place
~/.claude/skills/task-breakdown/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/task-breakdown/
1Skills CLI (Vercel)
npx skills add davidkiss/smart-ai-skills --skill task-breakdown -a codex2Manually: put the files in place
.agents/skills/task-breakdown/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add davidkiss/smart-ai-skills --skill task-breakdown -a cursor2Manually: put the files in place
.cursor/skills/task-breakdown/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install davidkiss/smart-ai-skills skills/task-breakdown2Manually: put the files in place
.github/skills/task-breakdown/SKILL.md1Skills CLI (Vercel)
npx skills add davidkiss/smart-ai-skills --skill task-breakdown -a gemini-cli2Platform CLI
gemini skills install https://github.com/davidkiss/smart-ai-skills --path skills/task-breakdownManually: put the files in place
.devin/skills/task-breakdown/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add davidkiss/smart-ai-skills --skill task-breakdown -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about task-breakdown
How to install task-breakdown in Claude Code?
Run npx skills add davidkiss/smart-ai-skills --skill task-breakdown -a claude-code in your terminal.
What does task-breakdown do?
It decomposes feature requirements into single-action steps with explicit file targets, test commands, and expected pass/fail outputs.
Where does the skill write the approved plan?
It outputs confirmed tasks into a markdown file under docs/YYYY-MM-DD-<feature-name>-tasks.md.
Similar skills
All skills for Agent setup: memory, context, orchestration →task-breakdown by other authors comes first.