CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

planning-workflow

Complete planning workflow orchestrating architecture planning, task breakdown, and progress tracking setup. Sequential workflow from requirements analysis through structure design and task breakdown to implementation tracking. Use when planning complex skills, setting up comprehensive project plans, or preparing for systematic skill development with full planning artifacts.

Quality

75%

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 ./.claude/skills/planning-workflow/SKILL.md

The canonical home for this skill is planning-workflow in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

56%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, well-sequenced 3-step orchestration with named outputs and dependencies, but it is dragged down by a redundant Quick Reference section that duplicates earlier content and by inlined sub-workflows of the component skills it delegates to. Guidance is actionable at the orchestration level yet incomplete at the execution level, with no validation checkpoints.

Suggestions

Remove the 'Quick Reference' section (or reduce it to the single table) — it restates the step/skill/time/output data, the 'When to Use' guidance, and the total time already given in the workflow sections; one copy is enough.

Drop the inlined sub-steps of the component skills (planning-architect's 6 steps, task-development's 5 steps) and instead point to those skills by path or clear signal, keeping only each step's purpose, input handoff, and output — this improves both conciseness and progressive disclosure.

Add lightweight checkpoints between steps, e.g. 'Confirm skill-architecture-plan.md is complete before starting task breakdown' and 'Verify every task in task-breakdown.md has an estimate and dependency before initializing the todo list', to give the workflow explicit validation without adding bulk.

DimensionReasoningScore

Conciseness

The body is mostly lean bullet-style prose, but the 'Quick Reference' section restates the step/skill/time/output information, the 'When to Use' guidance, and the total time already given in the workflow section, and the closing line repeats the Overview. That whole duplicated section is more than the minor trimming of the anchor at 4, fitting 'mostly efficient but could be tightened'.

3 / 5

Actionability

Concrete elements are present — named outputs (skill-architecture-plan.md, task-breakdown.md, todo-list.md), inter-step handoffs, and the specific 'todo-management Operation 1 (Initialize)' reference. But the inlined sub-steps ('Analyze requirements', 'Choose pattern', 'Design structure') are high-level hints with no invocation mechanics, document formats, or completion criteria, matching 'some concrete guidance but incomplete' rather than the minimal-guidance anchor at 2.

3 / 5

Workflow Clarity

The 3-step sequence is clear with explicit outputs, time estimates, and a stated dependency ('using plan from Step 1'), plus a post-workflow section describing how artifacts are used. No validation checkpoints exist, but this is non-destructive document creation so the destructive/batch cap does not apply; the gaps are minor relative to the anchor at 4 rather than the checkpoint-free bare-steps anchor at 3.

4 / 5

Progressive Disclosure

Sections are well organized with headers and a table, but the body inlines the component skills' internal workflows (planning-architect's 6 steps, task-development's 5 steps) — content that belongs in those components — and references the component skills by name only, with no paths or links. With no bundle files provided, this fits 'content that should be separate is inline; references not clearly signaled' rather than the well-split anchor at 4.

3 / 5

Total

13

/

20

Passed

Description

83%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: it explicitly states what the skill does and when to use it, in third person, with concrete trigger scenarios and multiple named actions. Its only weaknesses are process-level action naming and a slightly broad 'project plans' trigger that could overlap with generic planning skills.

DimensionReasoningScore

Specificity

The description names several concrete actions — 'architecture planning, task breakdown, and progress tracking setup' plus 'requirements analysis through structure design... to implementation tracking' — matching the 'several specific actions with minor gaps' anchor. It falls short of 5 because the actions are process-level names rather than fully concrete operations, and above 3 because more than 1-2 actions are explicitly listed.

4 / 5

Completeness

It explicitly answers both: 'what' (orchestrating architecture planning, task breakdown, and tracking setup in a sequential workflow) and 'when' ('Use when planning complex skills, setting up comprehensive project plans, or preparing for systematic skill development'). Both are present with concrete trigger phrases, matching the anchor at 5 rather than 4 where the 'when' would be less explicit.

5 / 5

Trigger Term Quality

'planning complex skills', 'setting up comprehensive project plans', and 'systematic skill development' are natural phrases a user would say, giving good keyword coverage. It misses common variations like 'break down tasks', 'create tasks', or 'todo list', keeping it below the comprehensive-synonym anchor at 5.

4 / 5

Distinctiveness Conflict Risk

The description is scoped to skill/project planning with named sub-activities, making it mostly distinct from other skills. The broad phrase 'setting up comprehensive project plans' leaves minor overlap risk with generic planning or todo-tracking skills, so it does not reach the clear-niche anchor at 5.

4 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

.claude/skills/planning-workflow/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.