CtrlK
BlogDocsLog inGet started
Tessl Logo

planning-and-task-breakdown

Breaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.

65

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/planning-and-task-breakdown/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The skill body is highly actionable with a clear, validated workflow and concrete templates. Its main weakness is moderate verbosity in motivational sections and inlining of material that a longer skill might split out.

Suggestions

Trim or cut 'Common Rationalizations' — it is motivational padding that does not change Claude's behavior and competes for context.

Consider moving the full plan-document template and task-structure template into a referenced file to keep SKILL.md as a leaner overview.

Verify the external reference path (../../references/definition-of-done.md) resolves in the deployment environment, since it points outside the skill bundle.

DimensionReasoningScore

Conciseness

The body is mostly efficient and avoids explaining basic concepts, but sections like 'Common Rationalizations' and the extended ASCII dependency graph add length that does not directly teach Claude something it does not already know, and some scaffolding could be tightened.

3 / 5

Actionability

Provides fully concrete, copy-paste-ready templates for task structure, checkpoints, and the plan document, with explicit file paths and field-by-field structure covering the common cases.

5 / 5

Workflow Clarity

The 5-step planning process is clearly sequenced with explicit ordering rationale (bottom-up, vertical slicing) and a dedicated Verification section plus per-phase checkpoints forming validate/review feedback loops before implementation begins.

5 / 5

Progressive Disclosure

Content is well-organized into clearly signaled sections with a single one-level-deep reference (definition-of-done.md) resolved via a relative path, but most reference material is inlined rather than split into separate files, leaving minor organization gaps.

4 / 5

Total

17

/

20

Passed

Description

75%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is third-person, concise, and answers both 'what' and 'when' with natural trigger phrases. It is strong overall but stops just short of comprehensive action listing and crisp trigger keywords.

Suggestions

Add 1-2 more concrete verbs describing the outputs (e.g. 'produces a dependency graph and a task list with acceptance criteria') to lift specificity.

Tighten the 'Use when' clauses into a compact comma-separated trigger list mirroring the good-example style (e.g. 'Use when breaking down a spec, estimating scope, or parallelizing work').

DimensionReasoningScore

Specificity

Names the domain ('Breaks work into ordered tasks') plus several concrete actions (estimate scope, parallelize), but the actions are procedural-situational rather than a comprehensive list of distinct operations, leaving minor coverage gaps.

4 / 5

Completeness

Clearly states both what ('Breaks work into ordered tasks') and when (multiple 'Use when...' clauses), but the 'when' is a list of situations rather than crisp concrete trigger phrases, so it is good but not maximally explicit.

4 / 5

Trigger Term Quality

Includes natural user-facing phrases ('a spec or clear requirements', 'a task feels too large to start', 'parallel work is possible') that a user would genuinely say, though it omits some common synonyms and explicit trigger keywords.

4 / 5

Distinctiveness Conflict Risk

The planning/spec-decomposition niche is mostly distinct from implementation skills, but there is minor overlap risk with general task-management or build skills that also produce task lists.

4 / 5

Total

16

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
addyosmani/agent-skills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.