CtrlK
BlogDocsLog inGet started
Tessl Logo

create-plan

Generate detailed implementation plans for complex tasks. Creates comprehensive strategic plans in Markdown format with objectives, step-by-step implementation tasks using checkbox format, verification criteria, risk assessments, and alternative approaches. All plans MUST be validated using the included validation script. Use when users need thorough analysis and structured planning before implementation, when breaking down complex features into actionable steps, or when they explicitly ask for a plan, roadmap, or strategy. Strictly planning-focused with no code modifications.

72

Quality

91%

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

SKILL.md
Quality
Evals
Security

Quality

Content

77%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 strong, highly actionable planning skill with an excellent validation feedback loop, held back by token redundancy and a progressive-disclosure miss: the bundled plan template and example plan are never referenced from SKILL.md, and their content is partially duplicated inline. The description-side trigger and workflow guidance are exemplary.

Suggestions

Replace the ~30-line inlined 'Plan Structure' template with a pointer to the bundled reference, e.g. 'Use the structure defined in [plan-template.md](references/plan-template.md)' — and similarly link example-plan.md as the worked example ('See [example-plan.md](references/example-plan.md) for a full example').

Consolidate the overlapping rules in 'Critical Requirements', 'Best Practices', and 'Boundaries' into a single section: the no-code rule and the assumptions guidance each currently appear twice, and 'Include clear rationale for each task' duplicates 'Write comprehensive tasks including what, why'.

Clarify the validation step's dependency for the reader: confirm the validate-plan.sh path resolves from the skill's installed location, or state where the script lives relative to the bundle (it is referenced but not present under the skill's own scripts/ directory).

DimensionReasoningScore

Conciseness

The body is mostly efficient and does not explain concepts Claude already knows, but it carries real redundancy: the no-code rule appears nearly verbatim in 'Critical Requirements' ('NEVER write code, code snippets, or code examples') and 'Boundaries' ('❌ Write code, code snippets, or code examples in plans'), the assumptions guidance appears in both 'Critical Requirements' and 'Best Practices', and the ~30-line inlined plan structure duplicates the bundled references/plan-template.md. This is 'mostly efficient but could be tightened' rather than the minor-trim profile of a 4.

3 / 5

Actionability

Guidance is concrete and executable throughout: exact naming convention with a worked example ('plans/2025-11-24-add-auth-v1.md'), a copy-paste validation command ('./.forge/skills/create-plan/validate-plan.sh plans/{YYYY-MM-DD}-{task-name}-v{N}.md'), named research tools (search, sem_search, read, sage), and an explicit citation format with a real example ('crates/forge_repo/src/provider.rs:45'). For an instruction-only skill this fully covers the common cases, matching the anchor-5 standard.

5 / 5

Workflow Clarity

The four-step process is clearly sequenced (assess → create with naming convention → validate → structure reference) and includes a mandatory validation checkpoint with an explicit feedback loop: 'Fix any errors or warnings and re-validate until the plan passes all checks', reinforced by 'ALWAYS validate the plan' in Critical Requirements. This matches the anchor-5 pattern of explicit validation steps with error-recovery loops.

5 / 5

Progressive Disclosure

The body itself is well-sectioned, but scored against the actual bundle: references/plan-template.md and references/example-plan.md exist yet are never mentioned or linked anywhere in SKILL.md, while a ~30-line plan-structure template (duplicating plan-template.md) is inlined in the body. That is 'content that should be separate is inline' plus unsignaled references — the anchor-3 profile; not 4 because the existing references are not clearly signaled at all, and not 2 because the body has clear section structure rather than being a monolithic wall.

3 / 5

Total

16

/

20

Passed

Description

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

An exemplary description: third-person voice, concrete capability list, explicit 'Use when...' triggers with synonyms, and a boundary clause that distinguishes it from implementation skills. Both what and when are answered explicitly with no fluff beyond mild intensifiers ('detailed', 'comprehensive').

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Creates comprehensive strategic plans in Markdown format with objectives, step-by-step implementation tasks using checkbox format, verification criteria, risk assessments, and alternative approaches' plus 'All plans MUST be validated using the included validation script' — giving comprehensive, specific coverage of what the skill does. It is not score 4 territory because coverage extends across all documented plan components rather than having minor gaps; not below because every action is concrete, not generic.

5 / 5

Completeness

Both questions are answered explicitly: the 'what' (generate Markdown plans with objectives, checkbox tasks, verification criteria, risks, alternatives) and the 'when' via a concrete 'Use when...' clause with three specific trigger conditions. It also adds a boundary statement ('Strictly planning-focused with no code modifications'), exceeding the anchor-5 example's completeness.

5 / 5

Trigger Term Quality

Natural trigger phrases users would actually say are covered with synonyms: 'Use when users need thorough analysis and structured planning before implementation, when breaking down complex features into actionable steps, or when they explicitly ask for a plan, roadmap, or strategy'. Matches the anchor-5 pattern of comprehensive natural terms including synonym variations (plan/roadmap/strategy); no meaningful natural phrasing is missing.

5 / 5

Distinctiveness Conflict Risk

It carves a clear niche — planning-only with an explicit boundary ('Strictly planning-focused with no code modifications') and distinct triggers (plan, roadmap, strategy, breaking down features) that would not fire for implementation or analysis skills. Conflict risk with other skills is minimal, matching the anchor-5 'clear niche with distinct triggers' example.

5 / 5

Total

20

/

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
tailcallhq/forgecode
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.