CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

writing-plans

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

Quality

71%

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 body is a strong, tightly written instruction skill: it prescribes an unambiguous workflow with copy-paste-ready templates, exact commands and expected outputs, and a built-in self-review validation loop. Its only weaknesses are mild — a few motivational asides and the somewhat tangled plans-folder naming (rubypowers vs. superpowers) that could be tightened.

DimensionReasoningScore

Conciseness

The body is dense and prescriptive with no padding about concepts Claude already knows, but a few passages could be trimmed: the motivational rationale in File Structure ("You reason best about code you can hold in context at once, and your edits are more reliable when files are focused") and the somewhat convoluted rubypowers/superpowers save-folder paragraph. That matches "efficient; minor instances of over-explanation" rather than the every-token-earns-its-place level of 5.

4 / 5

Actionability

Guidance is fully concrete and copy-paste ready: an exact plan-header template, a complete task template showing real test code, exact commands with expected output ("Run: `pytest tests/path/test.py::test_name -v` / Expected: FAIL with 'function not defined'"), exact commit commands, and an explicit forbidden-pattern list ("TBD", "Similar to Task N"). For an instruction-only skill this covers the common cases completely, matching the top anchor rather than 4.

5 / 5

Workflow Clarity

The multi-step process is clearly sequenced (scope check → file structure → task granularity → write plan → self-review → save → execution handoff) with explicit validation: the Self-Review section is a three-point checklist with a fix-inline feedback loop, and every task template embeds verify-it-fails/verify-it-passes checkpoints. This matches "clear sequence with explicit validation steps; feedback loops for error recovery; checklists" rather than the minor-gaps level of 4.

5 / 5

Progressive Disclosure

Sections are well-organized and there are no buried or nested references, and the body contains no dead-end pointer chains. However, the skill is roughly 150 lines with everything inline — including a 40-line task-structure example — which exceeds the under-50-lines exception for a reference-free 5, so it fits "good structure; most content appropriately placed; minor organization gaps".

4 / 5

Total

18

/

20

Passed

Description

40%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 trigger half of the description is strong — it is explicit, concrete, and correctly positions the skill in the pre-implementation window — but the capability half is entirely missing: the description never says the skill writes implementation plans, forcing reliance on the name field. Adding a "what" clause and the words "plan"/"planning" to the triggers would fix both gaps at once.

Suggestions

State the capability explicitly in the description, e.g. prefix it with "Writes comprehensive, bite-sized TDD implementation plans decomposed into per-task steps." so the description answers 'what' as well as 'when'.

Work natural trigger terms into the 'when' clause — users asking to "write an implementation plan", "plan this feature", or "break this spec down into tasks" would not currently match.

Mention key artifacts the skill produces (plan documents with exact file paths, failing-test-first tasks, commit checkpoints) to sharpen specificity beyond a bare domain reference.

DimensionReasoningScore

Specificity

The description names the domain ("a spec or requirements for a multi-step task, before touching code") but states no concrete actions or capabilities at all — what the skill actually does is never mentioned. It is not pure abstract fluff like "Helps with documents", so it fits the "names the domain but actions are minimal or generic" anchor rather than the one below.

2 / 5

Completeness

The description has a clear, explicit "when" ("Use when you have a spec or requirements for a multi-step task, before touching code") but no "what" — the capability (writing implementation plans) appears only in the skill name, not the description. This matches the "only 'when' is present without 'what'" anchor exactly; the score-3 anchor ("clear 'what', missing 'when'") is the opposite pattern.

2 / 5

Trigger Term Quality

"spec", "requirements", and "multi-step task" are phrases users would naturally say, but the skill's core noun — "plan", "planning", "implementation plan" — is entirely absent, along with common variants like "break this down". That is more than "a few natural terms missing", so it sits at the "some relevant keywords but missing common variations" anchor rather than 4.

3 / 5

Distinctiveness Conflict Risk

"have a spec" combined with "before touching code" carves a clear pre-implementation niche that would not draw execution or review skills. Overlap risk is minor and confined to closely related skills (e.g., brainstorming/spec creation), fitting "mostly distinct; minor overlap risk with closely related skills" rather than the broader overlap at 3.

4 / 5

Total

11

/

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

lucianghinda/superpowers-ruby

Path

skills/writing-plans/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.