CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-writing-plans

Create zero-context implementation plans with bite-sized tasks — use for multi-step feature planning

57

Quality

66%

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/skill-writing-plans/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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's core strength is actionability — the zero-context task template with complete code, exact commands, and expected outputs is exemplary and copy-paste ready. Weaker spots are the padded compliance rhetoric and incoherent decision-graph prose, and the absence of any bundle: a 340-line SKILL.md inlines full templates and a worked example that belong in one-level-deep reference files.

Suggestions

Move the full task template and the complete email-validator worked example into a references/ file (e.g. TASK_TEMPLATE.md), keeping only the shape and one compact example in SKILL.md.

Cut the "MANDATORY COMPLIANCE" section, "The Bottom Line", and the garbled sentences ("Beads is not an end-user requirement", "add provider calls from a seat") — they add tokens and confusion without actionable content.

Clarify the top-level plan-production sequence as an ordered list (decisions → header → tasks → checklist) so the workflow reads as a pipeline rather than a set of parallel sections.

DimensionReasoningScore

Conciseness

The templates, tables, and worked example are dense and mostly earn their tokens, but there is measurable padding: the "MANDATORY COMPLIANCE — DO NOT SKIP" section restates the obvious emotionally ("You are PROHIBITED from...", "The user asked for a plan, not an implementation"), "The Bottom Line" repeats the checklist, and filler like "Beads is not an end-user requirement" and "add provider calls from a seat" is incoherent noise. This matches anchor 3 — mostly efficient but includes unnecessary explanation and could be tightened — rather than anchor 4, whose over-explanation would be only minor.

3 / 5

Actionability

The body is fully executable: exact file paths with line ranges ("Modify: `exact/path/to/existing.ts` (lines 45-67)"), copy-paste ready TypeScript and bash in the task template, a complete worked example (email validator with full test and implementation code), and exact commands with expected outputs ("npm test tests/validators/email.spec.ts" → "PASS: 3/3 tests passed"). This matches anchor 5; it is not anchor 4 because there are no gaps in the common-case coverage.

5 / 5

Workflow Clarity

The per-task sequence has an explicit validation loop (write failing test → verify it fails → implement → verify it passes → commit) plus a final checklist — anchor 4's "clear sequence with most checkpoints present". It is not anchor 5 because the top-level sequence for producing a plan (decisions → header → tasks) is only implied by section order, and the "Decisions before tasks" section is garbled enough to muddy the workflow; it is well above anchor 3's merely-listed steps with implicit checkpoints.

4 / 5

Progressive Disclosure

There is no bundle at all (no references/, scripts/, or assets/ directories), and the body is a ~340-line monolith that inlines the full task template and the complete worked example — content that clearly belongs in separate reference files — matching anchor 3 (some structure via headers, but content that should be separate is inline). It is not anchor 4 because the one referenced path, `skills/blocks/engineering-method-selection.md`, points outside the skill bundle to an unverifiable plugin location and is not clearly signaled; it is above anchor 2 because sections, tables, and checklists keep it navigable rather than a wall of text.

3 / 5

Total

15

/

20

Passed

Description

62%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 concise, in third person, and answers both what and when, with a distinct niche. Its main weakness is thin trigger coverage — the natural phrases users actually say live in the separate trigger field rather than the description itself, which is what model invocation scoring evaluates.

Suggestions

Fold natural user phrasings into the description itself, e.g. "use when asked to 'plan how to implement X', 'create an implementation plan', or 'break down a feature into tasks'".

Add one or two more concrete capability terms (task decomposition, TDD task structure, exact file paths and verification steps) to lift specificity beyond a single action.

Mention the deliverable format (per-task file lists, test-first steps, commit points) to further differentiate from generic planning skills.

DimensionReasoningScore

Specificity

The description names one concrete action — "Create zero-context implementation plans with bite-sized tasks" — plus a single characteristic of the output, matching the anchor for 1-2 concrete actions without comprehensive coverage. It does not list several specific actions (task breakdown, TDD structuring, verification planning), so it falls below anchor 4.

3 / 5

Completeness

Both what ("Create zero-context implementation plans with bite-sized tasks") and when ("use for multi-step feature planning") are explicitly present in third person, matching anchor 4. It is not anchor 5 because the when-clause lacks concrete trigger phrases, and not anchor 3 because the when-clause is explicit rather than missing or weakly implied.

4 / 5

Trigger Term Quality

Relevant keywords are present ("implementation plans", "multi-step", "feature planning") but common natural variations users would say — "break down this feature", "plan how to implement X", "create a plan" — are absent from the description itself (they appear only in the separate trigger field). This matches anchor 3: some relevant keywords but missing common variations or synonyms.

3 / 5

Distinctiveness Conflict Risk

"Zero-context implementation plans" and "multi-step feature planning" carve a reasonably distinct niche distinct from generic planning or coding skills, matching anchor 4 (mostly distinct, minor overlap risk). It is not anchor 5 because the terms don't fully separate it from other planning/task-breakdown skills.

4 / 5

Total

14

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
nyldn/claude-octopus
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.