Dev & Engineering

Planning & Task Breakdown

Turn clear requirements into ordered, implementable, and verifiable engineering tasks.

54/ 100
Use with care

Useful, but reliability, evidence or controls still have material gaps.

See how it was scored ↓
Works as-is in
Codex · Claude Code
Stars
★ 107k
Last updated
13d ago
License
MIT
task-breakdownproject-planningacceptance-criteriadependency-management
+2parallelizationverification

What does this skill do, and when should you use it?

This skill helps AI coding agents decompose a specification or clear set of requirements into small, verifiable implementation tasks. It starts with read-only analysis of the specification and relevant code, then maps dependencies, slices work vertically, and defines acceptance criteria, verification steps, dependencies, likely files, and scope for each task. The plan is saved to tasks/plan.md and the checklist to tasks/todo.md. It is intended for work that is large, vague, or dependency-heavy, not obvious single-file changes.

Reads the specification and relevant codebase sections; identifies patterns, conventions, dependencies, risks, and unknowns; maps a dependency graph; divides work into vertical slices; writes tasks containing descriptions, acceptance criteria, verification steps, dependencies, likely files, and scope estimates; orders tasks into phases with checkpoints; saves the implementation plan to tasks/plan.md and the checklist to tasks/todo.md.

Good fit
  • A developer has a specification and needs implementable units before coding.
  • A technical lead has a task that feels too large or vague and needs smaller focused sessions.
  • Several agents or sessions may work in parallel and need clear dependency boundaries.
  • A team needs to communicate scope, verification standards, and open questions to a human reviewer.

How do you install this skill?

Before you use it
  • The skill requires writing tasks/plan.md and tasks/todo.md but does not specify confirmation, conflict handling, or rollback before overwriting existing files.
  • It references references/definition-of-done.md, which is absent from the supplied evidence; the skill should state which checks cannot proceed when it is missing.
  • Repository CI does not establish the quality of this specific skill's planning outputs; users still need to review plans manually.
  • No adaptation strategy is stated for Chinese-language tasks, non-Node projects, or mainland-China network constraints.
Before you start
Your agent needs
  • Shell / CLI
  • Local filesystem

This is an individual skill in the addyosmani/agent-skills repository at skills/planning-and-task-breakdown/SKILL.md. Install the full collection with npx skills add addyosmani/agent-skills. Install only this skill with npx skills add addyosmani/agent-skills --skill planning-and-task-breakdown. The README provides no additional installation procedure specific to this skill.

Generic route: install into Claude Code manually (macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/addyosmani/agent-skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/planning-and-task-breakdown" ~/.claude/skills/
rm -rf "$tmp"

Generated from the source repository and skill path; it copies only this skill's folder. If the author's install steps above differ, follow those first. To scope it to one project, replace ~/.claude/skills with that project's .claude/skills.

How do you use this skill?

Try saying

Once installed, send your agent any of these to trigger it:

  • Break this specification into implementation tasks. Read the relevant code first, create tasks/plan.md and tasks/todo.md, and do not write code yet.

Place the skill directory where the compatible Agent Skills client expects skills, then provide a specification or clear requirements and ask the agent to plan before coding. Example: "Break this specification into implementation tasks. Read the relevant code first, create tasks/plan.md and tasks/todo.md, and do not write code yet." The workflow expects human review and approval of the plan before implementation begins.

What are this skill's strengths and limitations?

Pros
  • Requires acceptance criteria and verification steps for every task.
  • Makes dependencies, implementation order, risks, and unknowns explicit.
  • Promotes vertical slices, checkpoints, and small task sizes.
  • Provides reusable templates for a plan document and task checklist.
Limitations
  • It plans and decomposes work but does not implement code, run tests, or deploy software.
  • Its expected outputs use the fixed paths tasks/plan.md and tasks/todo.md, which may require adapting an existing project convention.
  • The source provides no test suite, runtime metrics, or platform-specific validation for this individual skill.
  • Its example verification commands use npm, but the skill does not require Node.js or npm.

How does this skill compare with similar options?

Side by side with related skills; every score comes from the same FSRS standard.

Skill FS score Stars Last updated License
Planning & Task Breakdown this page 54 · Use with care ★ 107k 13d ago MIT
Spec-Driven Development 55 · Use with care ★ 107k 13d ago MIT
Harness Long-Running Agent Framework 50 · Use with care ★ 2.8k 5mo ago AGPL-3.0
Hermes Ephemeral Delegation 49 · Use with care ★ 7.8k 12d ago MIT
Writing Implementation Plans 42 · Not recommended ★ 2.9k 13d ago Apache-2.0

The README compares the overall Agent Skills collection with Superpowers and Matt Pocock's skills, but provides no standalone comparison for this planning skill.

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Use with care
54/ 100 5-point scale 2.7 / 5
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
1Trust17 / 25 · 3.4/5

The skill requires read-only planning and emphasizes dependencies, risks, acceptance criteria, verification, and human approval. No malware, credential handling, external calls, or destructive defaults are evident; however, data-flow disclosure, sensitive-data handling, rollback guidance, and source attribution are not explicit, so points are deducted.

2Reliability8 / 20 · 2.0/5

The workflow, task template, dependency ordering, and checkpoints are largely consistent. Abnormal-input handling and diagnosable stop conditions are thin, and no skill-specific execution tests are supplied; under static calibration the score is capped at 10 and deductions apply.

3Adaptability11 / 15 · 3.7/5

Audience, use cases, and non-fit cases are clearly stated, including parallelization and task sizing. Input/output boundaries, agent-environment compatibility, Chinese-language support, and mainland-China reachability are not declared, so points are deducted.

4Convention9 / 15 · 3.0/5

The skill has clear structure, progressive workflow, templates, examples, limitations, and a verification checklist. The repository supplies an MIT license, but the skill lacks versioning, changelog, maintenance ownership, and update path; its referenced definition-of-done.md is not included in the supplied evidence, so points are deducted.

5Effectiveness6 / 15 · 2.0/5

It can directly produce tasks/plan.md and tasks/todo.md with acceptance criteria, dependencies, file scope, and verification steps, giving it clear core utility. No representative artifact or independent outcome evidence is provided, and human review remains necessary; static calibration caps this at 7, so points are deducted.

6Verifiability3 / 10 · 1.5/5

Repository CI provides limited auditable evidence through skill validation, trigger/routing evaluations, and test execution. The supplied evidence does not show coverage of this skill's key paths or independent third-party reproduction, so points are deducted.

1 2 3 4 5 6

Open a dimension to read why it scored that way

Reviewed Jul 20, 2026 Reviewed revision 2fbfa004a019 Review evidence[1][2][3][4][5]

Evidence confidence:Low — Mostly static review, author material or a limited demo; useful for discovery, not high-risk decisions.

See the full review method →

FAQ

Is this skill appropriate for a small, obvious single-file change?
Usually not. The SKILL.md explicitly lists single-file changes with obvious scope as a case where it should not be used.
Will it modify the codebase directly?
No. The planning phase is read-only and produces tasks/plan.md and tasks/todo.md rather than implementation code.
Does it require external services or a specific dependency?
The source shows no requirement for network access, MCP, or named software dependencies. It does require reading the codebase and writing planning files.
Can it support parallel development?
Yes. It identifies independent work that can be parallelized while marking database migrations, shared-state changes, and dependency chains as sequential work.

More skills from this repository

All from addyosmani/agent-skills

Dev & Engineering

Spec-Driven Development

Turn ambiguous engineering requests into testable specifications before coding.

★ 107k FS 55 Use with care 13d ago
Dev & Engineering

Context Engineering

Helps coding agents load the right project context at the right time, reducing guesswork and convention drift.

★ 107k FS 49 Use with care 13d ago
Automation & Ops

Security Hardening Engineering Skill

Gives coding agents a structured defense workflow for untrusted input, authentication, sensitive data, and external service integrations.

★ 107k FS 52 Use with care 13d ago
Dev & Engineering

Engineering Workflow Navigator

Find and invoke the right engineering workflow skill for each task phase.

★ 107k FS 46 Use with care 13d ago
Design & Frontend

Production Frontend UI Engineering

Guides AI coding agents to build accessible, responsive, design-system-aligned production interfaces.

★ 107k FS 53 Use with care 13d ago
Dev & Engineering

Doubt-Driven Development

Challenge non-trivial decisions with a fresh adversarial review before they stand.

★ 107k FS 52 Use with care 13d ago
Dev & Engineering

Incremental Implementation

Deliver multi-file engineering changes through small, tested, reversible slices.

★ 107k FS 52 Use with care 13d ago
Dev & Engineering

Source-Driven Development

Ground framework and library decisions in current official documentation instead of stale memory.

★ 107k FS 51 Use with care 13d ago
Dev & Engineering

Pre-Merge Code Quality Review

Review every change across correctness, readability, architecture, security, and performance before it reaches the main branch.

★ 107k FS 49 Use with care 13d ago
Dev & Engineering

Deprecation & Migration

A practical workflow for retiring legacy systems safely and moving users to replacements.

★ 107k FS 48 Use with care 13d ago
Dev & Engineering

Browser DevTools Testing

Validate and debug web applications with real-browser runtime evidence.

★ 107k FS 59 Recommended 13d ago
Dev & Engineering

Intent Interviewer

Clarify the real problem through one-question-at-a-time interviews before planning or coding.

★ 107k FS 59 Recommended 13d ago
Dev & Engineering

Test-Driven Development Workflow

Prove intended behavior with a failing test before implementing, refactoring, and verifying the change.

★ 107k FS 57 Use with care 13d ago
Dev & Engineering

Code Clarity Refactor

Reduce code complexity while preserving exact behavior, so teammates can read, modify, and debug it faster.

★ 107k FS 57 Use with care 13d ago
Dev & Engineering

Git Workflow & Release Discipline

Keep AI-generated changes reviewable, reversible, and ready to release.

★ 107k FS 54 Use with care 13d ago
Dev & Engineering

Performance Optimization Engineering Skill

Measure, diagnose, and verify fixes for frontend, backend, query, and database performance bottlenecks.

★ 107k FS 54 Use with care 13d ago
Dev & Engineering

Architecture Decisions & Docs

Preserve engineering context by documenting decisions, APIs, and the reasons behind them.

★ 107k FS 53 Use with care 13d ago
Automation & Ops

Production Observability

Make production behavior visible and diagnosable with structured logs, metrics, traces, and actionable alerts.

★ 107k FS 53 Use with care 13d ago
Dev & Engineering

Idea Refine

Turn vague ideas into tested, actionable product directions.

★ 107k FS 51 Use with care 13d ago
Dev & Engineering

Stable Interface Design

A practical guide to designing stable, clear, and hard-to-misuse APIs and module interfaces.

★ 107k FS 50 Use with care 13d ago

Related skills