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

56

Quality

70%

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 ./plugins/superpowers/skills/writing-plans/SKILL.md

The canonical home for this skill is writing-plans in obra/superpowers

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.

A strong instruction-only skill: it provides exact templates, commands with expected outputs, an explicit no-placeholder red-flag list, and a self-review checklist with feedback loops. The only weaknesses are mild redundancy between the two task-granularity sections and fully inlined templates that could live in reference files.

DimensionReasoningScore

Conciseness

The body is dense with directives ('fold setup, configuration, scaffolding, and documentation steps into the task whose deliverable needs them') with no padded tutorial prose. Minor trimming is possible — 'Task Right-Sizing' and 'Bite-Sized Task Granularity' overlap, and lines like 'You reason best about code you can hold in context at once...' add rationale Claude does not need.

4 / 5

Actionability

Fully executable guidance: exact plan header template, task structure with precise paths and line ranges ('Modify: `exact/path/to/existing.py:123-145`'), runnable commands with expected results ('Run: `pytest tests/path/test.py::test_name -v` / Expected: FAIL with "function not defined"'), commit message examples, and a concrete named-bug example (clearLayers() vs clearFullLayers()). Copy-paste ready throughout.

5 / 5

Workflow Clarity

Clear top-level sequence (announce → scope check → file structure → tasks → save → self-review → execution handoff) with an explicit Self-Review checklist covering spec coverage, placeholder scanning, and type consistency, plus a fix-inline feedback loop. Validation checkpoints (verify-fails / verify-passes) are embedded in every task cycle.

5 / 5

Progressive Disclosure

Well-organized sections with all content appropriately placed and sub-skill references clearly signaled by name, but no bundle files exist while the full plan-header and task-structure templates are inlined in SKILL.md. At ~170 lines the under-50-line simple-skill exception does not apply; externalizing the templates into a reference file would tighten the overview.

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 is a clean, well-formed trigger clause but only half a description: it says precisely when to use the skill while saying nothing about what the skill does (writes comprehensive, bite-sized implementation plans). Adding a what-statement and plan-related synonyms would move it from below midpoint to solid.

Suggestions

Completeness: lead with a what-statement, e.g. 'Write comprehensive implementation plans with bite-sized, test-first tasks from a spec or requirements. Use when you have a spec for a multi-step task, before touching code.'

Specificity: name 2-3 concrete actions the skill performs — e.g. 'maps files to create/modify, breaks work into 2-5 minute TDD steps, and includes exact test commands and commit points' — so the description conveys capability, not just timing.

Trigger term quality: add the natural synonyms users actually say — 'plan', 'implementation plan', 'design doc', and 'before coding/starting implementation' — not just 'spec or requirements'.

DimensionReasoningScore

Specificity

The description names the domain ('a spec or requirements for a multi-step task, before touching code') but contains no action verbs — it never states what the skill does, e.g. 'Writes implementation plans'. Anchor 2 ('Names the domain but actions are minimal or generic') fits; anchor 3 requires 1-2 concrete actions which are absent, and anchor 1 would require vague, abstract language rather than a sharply defined situation.

2 / 5

Completeness

The 'when' is explicit and specific ('Use when you have a spec or requirements for a multi-step task, before touching code') but the 'what' is entirely missing. Anchor 2 explicitly covers 'only when is present without what'; anchor 3 requires a clear 'what', which this description lacks.

2 / 5

Trigger Term Quality

'Spec' and 'requirements' are natural user phrases, and 'before touching code' matches how users describe pre-implementation work. However common synonyms are missing: 'plan', 'implementation plan', 'design doc'. Anchor 3 ('Some relevant keywords but missing common variations or synonyms') fits better than 4, whose keyword coverage is broader.

3 / 5

Distinctiveness Conflict Risk

'Before touching code' plus the spec prerequisite situates the skill reasonably well, but it would overlap with sibling planning skills (brainstorming, executing-plans) and does not state a distinguishing capability. Anchor 3 ('Somewhat specific but could still overlap with similar skills') fits; anchor 4 would require clearly distinct triggers.

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

openai/plugins

Path

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