CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-writing-plans

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

58

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 ./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.

A strongly actionable, template-driven skill with complete code, exact commands, expected outputs, and an embedded TDD validation loop. It loses points on token efficiency (duplicated template/example and compliance padding) and on structure, since heavy template content is inlined and bundle references are absent from the skill directory.

Suggestions

Move the full "Example: Complete Task" (and optionally the generic Task Template) into a reference file such as references/task-template.md, keeping only a compact skeleton in SKILL.md.

Trim the "MANDATORY COMPLIANCE" block to one or two lines — the prohibitions and the "The user asked for a plan" line restate the same constraint three times.

Resolve or replace the dangling "skills/blocks/*.md" references with real files in a references/ directory, and cut or drastically shorten the off-topic "Decisions before tasks" tracker section.

DimensionReasoningScore

Conciseness

The body is mostly concrete templates and tables rather than explanation of known concepts, but there are padded sections: the ~80-line "Example: Complete Task" largely restates the Task Template, the "MANDATORY COMPLIANCE" block repeats its prohibition three ways, and the "Decisions before tasks" section (tracker claiming, "Beads is not an end-user requirement") drifts off-topic. Not a 2 because the bulk is directly actionable material, and not a 4 because the duplicate example and compliance padding are clearly trimmable.

3 / 5

Actionability

Guidance is fully executable and copy-paste ready: exact file paths ("Create: `src/validators/email.ts`"), complete TypeScript test and implementation code, exact commands ("npm test tests/validators/email.spec.ts") with expected output strings, and commit commands with messages. The worked example covers the common case end-to-end.

5 / 5

Workflow Clarity

The task template lays out an explicit TDD sequence with validation checkpoints (write failing test → verify it fails → implement → verify it passes → commit), and checklists reinforce it. Not a 5 because the top-level plan-creation workflow is organizational rather than sequenced, and error-recovery guidance exists implicitly via expected outputs but is not spelled out as a feedback loop.

4 / 5

Progressive Disclosure

Sections are well-organized with clear headers, but the body is ~340 lines of monolithic content — the full worked example and the long task template are strong candidates for separate reference files. The two file references ("skills/blocks/engineering-method-selection.md", "skills/blocks/codex-host-adapter.md") point to plugin-internal paths, and this bundle has no references/, scripts/, or assets/ directories, so navigation to detail files is not clearly signaled within the skill.

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.

A concise, third-person description that answers what and when in one line, with a reasonably distinct planning niche. Its main weaknesses are limited action coverage and thin trigger-term variety — a single 'use for' clause without synonyms or user-natural phrasings.

Suggestions

Expand the 'what' with 2-3 concrete plan contents (e.g., exact file paths, complete code per task, test commands with expected output) to lift specificity.

Broaden trigger terms with natural user phrasings such as "plan a feature", "break work into tasks", or "prepare tasks for delegation to subagents".

Make the 'when' clause more explicit about trigger moments, e.g., "Use when the user asks to plan a multi-step feature or wants a plan before implementation."

DimensionReasoningScore

Specificity

The description names one core action — "Create zero-context implementation plans" — with the attributes "zero-context" and "bite-sized tasks", which is domain-plus-1-2-concrete-actions coverage rather than the multiple specific actions of a 4 or 5. It does not list what a plan contains (file paths, test steps, commits), so it is not comprehensive.

3 / 5

Completeness

Both parts are present: the what is "Create zero-context implementation plans with bite-sized tasks" and the when is the explicit "use for multi-step feature planning". It is not a 5 because the when is a single terse clause — it lacks concrete trigger phrases like "when the user asks to plan a feature or break work into tasks".

4 / 5

Trigger Term Quality

"implementation plans" and "multi-step feature planning" are relevant phrases a user might say, but common variations are missing: "write a plan", "break down work", "task breakdown", "plan a feature". Coverage is partial rather than good (4) since several natural trigger phrasings users would actually use are absent.

3 / 5

Distinctiveness Conflict Risk

The zero-context/bite-sized-task planning niche is fairly distinct from execution or review skills, with "implementation plans" as a clear discriminator. Minor overlap remains with general project-planning, roadmap, or decomposition skills, so it does not reach the clear-niche level of 5.

4 / 5

Total

14

/

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