CtrlK
BlogDocsLog inGet started
Tessl Logo

writing-plans

Use when you have a spec or requirements for a multi-step task, before touching code

56

Quality

62%

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

Quality

Content

88%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 content is a strong, highly actionable skill: concrete templates, explicit validation checkpoints, a self-review checklist with feedback loops, and disciplined conciseness that assumes Claude's competence. Its only structural question is whether the two large embedded templates might belong in a one-level-deep reference file rather than inline.

DimensionReasoningScore

Conciseness

The body is dense and decisive — it assumes Claude's competence (no explanation of what git commits or tests are) and every section prescribes rather than describes. Minor trimming is possible: the bracketed prose inside the plan-header template (e.g., the 14-line "Review Focus" explanation) and repeated sub-skill mentions in Execution Handoff run slightly long. This matches anchor 4 ('Efficient; minor instances of over-explanation that could be trimmed'); it is not score 5 because a few template comment blocks restate the same principle multiple times, and not score 3 because there is no genuinely unnecessary conceptual explanation.

4 / 5

Actionability

Fully executable throughout: exact save path (`docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md`), copy-paste-ready markdown templates with checkbox step syntax, concrete commands with expected output ("Run: `pytest tests/path/test.py::test_name -v` / Expected: FAIL with 'function not defined'"), and verbatim dialogue scripts for the handoff. This matches anchor 5 ('copy-paste ready code or commands; specific examples cover the common cases'); placeholders like `test_specific_behavior` are inherent to a plan-writing skill and the template covers the common case completely.

5 / 5

Workflow Clarity

The multi-step process is clearly sequenced — announce, scope check, file structure, task right-sizing, write header and tasks, self-review, save, execution handoff — with explicit validation checkpoints: each task template includes "run test to verify it fails" and "run test to verify it passes", and the Self-Review section is an explicit five-point checklist with a fix-inline-and-move-on feedback loop. This matches anchor 5 ('Clear sequence with explicit validation steps; feedback loops for error recovery; checklists for complex processes').

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so the skill is a single well-sectioned file — sections are clearly labeled and navigation is easy, matching anchor 4 ('Good structure; most content is appropriately placed; minor organization gaps'). It is not score 5 because at ~200 lines with two large embedded templates (plan header, task structure), some material could arguably live in a one-level-deep reference file; it is not score 3 because nothing that belongs in a separate file is truly buried and organization is consistent throughout.

4 / 5

Total

18

/

20

Passed

Description

36%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 has a clear, explicit 'when' trigger with reasonably natural phrasing, but it completely omits the 'what' — it never says the skill writes implementation plans. Adding a leading action clause would fix both completeness and specificity at once.

Suggestions

Lead with a concrete 'what' clause, e.g., "Writes detailed, test-driven implementation plans broken into bite-sized tasks from a spec or requirements. Use when you have a spec or requirements for a multi-step task, before touching code."

Include the natural trigger synonyms users would actually say — "plan", "implementation plan", "planning" — since none currently appear in the description.

Optionally state the deliverable location ("saves the plan to docs/plans/") to further sharpen the what-clause.

DimensionReasoningScore

Specificity

The description names the domain ("a spec or requirements for a multi-step task") but never states a concrete action — there is no verb for what the skill does (e.g., "Writes implementation plans"). This matches anchor 2 ('Names the domain but actions are minimal or generic'); it is not score 1 because the domain framing is specific rather than entirely vague, and not score 3 because no concrete action is named at all.

2 / 5

Completeness

Only the 'when' is present ("Use when you have a spec or requirements for a multi-step task, before touching code"); the 'what' — what the skill actually does — is entirely absent. This matches anchor 2 ('only when is present without what'); it is not score 3 because a clear 'what' is missing, not merely weakly implied, and not score 1 because the 'when' clause is explicit and specific.

2 / 5

Trigger Term Quality

It includes some natural phrases users would say — "spec", "requirements", "multi-step task", "before touching code" — but misses common synonyms and variations such as "plan", "planning", "implementation plan", or "break this down". This matches anchor 3 ('Some relevant keywords but missing common variations or synonyms'); score 4 would require tighter keyword coverage including those planning-related terms.

3 / 5

Distinctiveness Conflict Risk

"Spec or requirements for a multi-step task" is somewhat specific to the planning niche, but without a stated 'what', it could overlap with adjacent skills that trigger on specs (e.g., spec review, brainstorming, requirement analysis). This matches anchor 3 ('Somewhat specific but could still overlap with similar skills'); it is not score 4 because the missing 'what' leaves the trigger set broad enough to plausibly collide with related spec-handling skills.

3 / 5

Total

10

/

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