CtrlK
BlogDocsLog inGet started
Tessl Logo

writing-plans

Extends superpowers:writing-plans with devflow's phase-handoff at the end.

60

Quality

75%

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 ./devflow-plugin/skills/writing-plans/SKILL.md

The canonical home for this skill is writing-plans in AndreJorgeLopes/devflow

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 highly actionable and well-sequenced with strong validation and error-recovery, and it stays lean by assuming Claude's competence. The only weakness is mild verbosity in a few inline explanatory comments that could be tightened.

DimensionReasoningScore

Conciseness

The body is dense, assumes Claude's git competence, and avoids explaining basic concepts; it is not score 5 because several lengthy inline comments (e.g. the `[ -d ]` rationale and the spawn_task aside) over-explain edge cases that could be trimmed, and not score 3 because the prose overall is efficient and earns most of its tokens.

4 / 5

Actionability

It provides copy-paste-ready bash with concrete git worktree commands, a literal ticket regex `[A-Z]+-[0-9]+`, an exact terminal-title escape sequence, a concrete mark_chapter call, and explicit handoff arguments (`--phase plan --next-phase lock-tests`) with a recovery fallback; this fully matches the executable, common-case-covered anchor.

5 / 5

Workflow Clarity

Steps are clearly sequenced (Step 0 worktree, Before first-action, After plan-saved) with explicit validation (the branch check that exits with 'WORKTREE RECOVERY FAILED') and a feedback/recovery loop (try `worktree add`, else reuse the existing checkout); this matches the explicit-validation-with-feedback-loops anchor.

5 / 5

Progressive Disclosure

It is a self-contained, well-sectioned single-purpose skill with clear headers and no nested or buried references; per the simple-skill note, well-organized sections with no need for external references score 5, and there are no bundle files to misreference.

5 / 5

Total

19

/

20

Passed

Description

46%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 conveys a clear, narrow 'what' but omits any explicit 'when to use it' trigger guidance and relies on plugin jargon instead of natural user keywords. Adding a concrete 'Use when...' clause with natural phrasing would lift the two lowest dimensions.

Suggestions

Append an explicit 'Use when...' clause stating the natural trigger, e.g. 'Use when writing an implementation plan that must hand off to the lock-tests phase via devflow.'

Replace or augment the plugin jargon ('phase-handoff', 'devflow') with natural keywords a user would actually say, such as 'writing an implementation plan' or 'planning phase'.

Spell out the concrete action more fully — what the phase-handoff produces (a frozen-state file and a spawned next-phase session) — to broaden specificity beyond a single named action.

DimensionReasoningScore

Specificity

Names the domain ('superpowers:writing-plans') and one concrete action ('devflow's phase-handoff at the end'), matching the anchor for 1-2 concrete actions without being comprehensive; not score 2 because the action is specific rather than generic, not score 4 because only a single action is named.

3 / 5

Completeness

It has a clear 'what' (extends writing-plans with phase-handoff at the end) but no 'when'/Use-when clause at all, so per the missing-trigger-guidance cap it cannot exceed 3; not score 4 because the 'when' is entirely absent rather than merely implicit.

3 / 5

Trigger Term Quality

The terms 'writing-plans', 'phase-handoff', and 'devflow' are plugin/skill jargon rather than natural phrases a user would say; not score 1 because 'writing-plans' is at least a recognizable concept, but it misses the common natural variations users actually utter.

2 / 5

Distinctiveness Conflict Risk

It is scoped to extending two specific named skills, giving it a clear niche with only minor overlap risk against the base writing-plans skill; not score 5 because it depends on the base skill's triggers and could co-trigger with it.

4 / 5

Total

12

/

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