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

77%

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-workflow/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-structured orchestrator document with clear sequencing and concrete skill/output references, weakened by structural redundancy and absent validation checkpoints. The Quick Reference and Post-Workflow sections duplicate earlier content, and no step verifies its artifact before the next begins.

Suggestions

Remove the Quick Reference table and the duplicated 'When to Use' line — both repeat the Overview and Planning Workflow sections verbatim — cutting the document roughly in half.

Add a validation checkpoint between steps (e.g., 'Confirm skill-architecture-plan.md is complete and actionable before starting task development') plus a brief recovery path if an artifact is incomplete.

Make the data flow explicit: state that task-development consumes skill-architecture-plan.md as its input and where each output document is written.

DimensionReasoningScore

Conciseness

Each section is individually lean with no explanations of concepts Claude already knows, but the Quick Reference table fully duplicates the Overview and Planning Workflow sections (steps, skills, times, outputs all repeated), 'When to Use' appears twice, and 'Post-Workflow' adds little. This fits 'mostly efficient but could be tightened' — roughly 100 lines where ~50 would suffice — but not the 2 anchor, which requires padded concept explanations.

3 / 5

Actionability

Guidance is concrete and directive: 'Run planning-architect 6-step workflow', 'Use todo-management Operation 1 (Initialize)', with named outputs (skill-architecture-plan.md, task-breakdown.md, todo-list.md) and durations per step. It is not 5 because the sub-steps are bare labels ('Analyze requirements, Choose pattern...') and it never specifies how outputs feed forward or how to invoke the sub-skills; it is above 3 because the orchestration instructions are specific and executable, not pseudocode-level.

4 / 5

Workflow Clarity

The 3-step sequence is explicit with clear data dependencies ('using plan from Step 1', 'Create todo list from task breakdown'), but there are zero validation checkpoints — no instruction to confirm an artifact is complete before proceeding and no error-recovery guidance. This exactly matches the anchor 'steps listed but validation gaps; checkpoints missing or implicit'; it is not 4 because 'most checkpoints present' is false. The operations are non-destructive document creation, so no lower cap applies.

3 / 5

Progressive Disclosure

No bundle files exist and none are referenced; the body is a self-contained orchestrator overview with well-labeled sections and easy navigation, and the referenced detail material appropriately lives in the component skills. It is not 5 because the body exceeds 50 lines and carries a fully duplicated Quick Reference section that could be consolidated; it is above 3 because structure and navigation are good and nothing belongs in a separate file.

4 / 5

Total

14

/

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: third-person voice, explicit 'Use when' triggers with three concrete scenarios, and several named actions. Weaknesses are minor — some trigger variations are missing and the middle sentence partially duplicates the first. Low conflict risk except against its own component skills.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'orchestrating architecture planning, task breakdown, and progress tracking setup' — with minor gaps in coverage, matching the anchor for several specific actions. It is not 5 because the actions are process-level abstractions and the second sentence redundantly restates 'task breakdown' rather than broadening coverage; it is above 3 because more than 1-2 distinct actions are explicitly named.

4 / 5

Completeness

It clearly answers both 'what' ('Complete planning workflow orchestrating architecture planning, task breakdown, and progress tracking setup') and 'when' with an explicit 'Use when' clause containing three concrete trigger scenarios. It matches the 5 anchor exactly; the 'when' is explicit and specific, so it is not the 4 anchor where the trigger guidance is only generically stated.

5 / 5

Trigger Term Quality

Natural phrases like 'planning complex skills', 'comprehensive project plans', 'task breakdown', and 'progress tracking' give good keyword coverage of what users would say. It is not 5 because common variations and synonyms ('roadmap', 'break down work', 'todos', 'estimates') are missing; it is above 3 because several relevant natural terms are present, not just one generic keyword.

4 / 5

Distinctiveness Conflict Risk

It carves out a distinct orchestrator niche ('Complete planning workflow... with full planning artifacts') with mostly distinct triggers. It is not 5 because generic planning triggers ('setting up comprehensive project plans') could route users who only need one component skill — the body itself says 'For simple skills, use planning-architect only' — creating minor overlap risk with closely related skills.

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

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.