CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

planner

Create structured plans for multi-task projects that can be executed by the task-orchestrator skill. Use when breaking down complex work into parallel/sequential tasks with dependencies.

78

2.47x
Quality

73%

Does it follow best practices?

Impact

99%

2.47x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/planner/SKILL.md

The canonical home for this skill is planner in jdrhyne/agent-skills

SKILL.md
Quality
Evals
Security

Quality

Content

57%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 body presents a clear overview with a strong plan template and a genuinely instructive bad-vs-good task breakdown, but it is a shell around two prompt files that are absent from the bundle, leaving the executable process and validation loops unspecified. As written, a reader cannot follow the Quick Start's first instruction.

Suggestions

Ship `prompts/planner.md` and `prompts/parallel-task.md` in the bundle (or inline their essential process steps in SKILL.md) so the core instruction "Load the full planner prompt from prompts/planner.md" is actually followable.

Add an explicit feedback loop after Phase 3, e.g., "If the subagent review finds issues, revise the affected tasks and re-run the review until it passes" — currently the outcome of the review checkpoint is undefined.

Expand the Phase 0–4 one-liners with the key decision points per phase (e.g., what makes a task 'atomic', how dependencies are declared) so the skill degrades gracefully if the prompt file is unavailable.

DimensionReasoningScore

Conciseness

The body is largely efficient — compact key principles, a bad-vs-good example, and a template — with only minor trimmable content: the am-will/codex-skills attribution appears twice ("Source: Based on..." and "Both are based on am-will's codex-skills prompts") and the sprint/task principles partially restate what the template already encodes. It is not a 5 because of this duplication, and not a 3 because no section is genuinely padded or explains concepts Claude already knows.

4 / 5

Actionability

The plan template is concrete and copy-paste ready, but the actual planning process — the skill's core instruction — is delegated entirely to `prompts/planner.md` ("Load the full planner prompt... and follow its process"), which is not present in the bundle, and the Phase 0–4 list gives only one-line hints ("Research & understand the codebase"). This matches 'some concrete guidance but incomplete; missing key details' rather than a 4, whose gaps would be minor.

3 / 5

Workflow Clarity

The five phases are clearly sequenced and Phase 3 ("Subagent review of the plan") names a checkpoint, but there is no feedback loop specifying what to do when the review finds problems, and the per-phase detail needed to actually execute the sequence lives in the missing prompt file. This sits at 'sequence present but checkpoints missing or implicit', not a 4, which would require most checkpoints with explicit validation handling.

3 / 5

Progressive Disclosure

References to `prompts/planner.md` and `prompts/parallel-task.md` are clearly signaled and one level deep, but the bundle contains no prompts/ directory, so both references are dangling and the skill is unnavigable as shipped; the ~45-line plan template is also inlined where the referenced prompt file would naturally hold it. Structure exists (headed sections, a Files list), but the broken references and inline bulk keep this at 'some structure but could be better organized' rather than a 4.

3 / 5

Total

13

/

20

Passed

Description

78%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.

A strong description that explicitly covers both what the skill does and when to use it, in third person, with natural trigger phrases. Its main weakness is limited action specificity — it names one core action rather than enumerating the concrete planning activities.

DimensionReasoningScore

Specificity

"Create structured plans for multi-task projects" names the domain plus one concrete action (create structured plans), matching the '1-2 concrete actions, but not comprehensive' anchor; it does not list several specific actions (e.g., decompose into sprints, define dependencies, draft acceptance criteria) that would warrant a 4.

3 / 5

Completeness

It clearly answers both questions: the "what" is "Create structured plans for multi-task projects that can be executed by the task-orchestrator skill" and the "when" is an explicit "Use when breaking down complex work into parallel/sequential tasks with dependencies" clause with concrete trigger conditions, mirroring the score-5 example; it is not a 4 because the when-clause is already specific rather than improvable.

5 / 5

Trigger Term Quality

Natural phrases like "structured plans", "breaking down complex work", "parallel/sequential tasks", and "dependencies" are terms users would plausibly say when needing this skill; common variations such as "roadmap", "sprint", "milestone", or "project plan" are missing, keeping it below a 5.

4 / 5

Distinctiveness Conflict Risk

The pairing with the task-orchestrator skill and the parallel/dependencies framing give it a mostly distinct niche with only minor overlap risk against generic planning or task-management skills; it is not a 5 because "create plans for complex work" could still collide with other project-planning skills.

4 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

bap-jorkim/agent-skills-fork-feb-25

Path

skills/planner/SKILL.md

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.