CtrlK
BlogDocsLog inGet started
Tessl Logo

writing-plans

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

54

Quality

60%

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

85%

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 highly actionable, well-sequenced workflow with executable code and explicit validation, succeeding as an extension of a parent skill; its only weakness is minor verbosity in the inline rationale.

DimensionReasoningScore

Conciseness

The body is dense and mostly assumes Claude's git competence, with justified edge-case comments, but several explanatory asides (e.g., "spawn_task always forks off the default branch; there is no way to pin it", the awk-token rationale) could be tightened.

2 / 3

Actionability

It provides fully executable bash, an exact regex (`[A-Z]+-[0-9]+`), precise `mark_chapter` arguments, and a concrete `devflow:phase-handoff` invocation with arguments — copy-paste ready.

3 / 3

Workflow Clarity

A clear Step 0 / Before / After sequence includes an explicit validation checkpoint (`WORKTREE RECOVERY FAILED...; exit 1`) and a fallback feedback loop that reuses an existing checkout when `worktree add` fails.

3 / 3

Progressive Disclosure

No bundle files exist and none are needed; the single-purpose skill is organized into well-signaled sections (Step 0, Before, After) with one-level references to other skills rather than nested file chains.

3 / 3

Total

11

/

12

Passed

Description

35%

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 specific about its niche (extending a particular plan-writing skill with phase-handoff) but relies entirely on technical skill names rather than natural user triggers and omits any "Use when" guidance.

Suggestions

Add an explicit "Use when..." clause naming natural triggers (e.g., when writing an implementation plan as part of a devflow phase handoff).

Replace or supplement the namespaced jargon ("superpowers:writing-plans", "devflow's phase-handoff") with plain-language terms users would actually say.

Briefly enumerate the concrete actions performed so the skill's capabilities are comprehensive, not just a single "extends" verb.

DimensionReasoningScore

Specificity

Names a concrete action ("Extends superpowers:writing-plans with devflow's phase-handoff at the end") and a specific domain, but lists only a single action rather than multiple concrete capabilities.

2 / 3

Completeness

It states what the skill does (extends writing-plans with phase-handoff) but provides no "Use when..." or equivalent explicit trigger for when to invoke it, capping completeness at 2 per the guidelines.

2 / 3

Trigger Term Quality

The terms are plugin-namespaced skill identifiers ("superpowers:writing-plans", "devflow's phase-handoff") — technical jargon a user would not naturally utter when requesting this skill.

1 / 3

Distinctiveness Conflict Risk

It explicitly extends a named skill, but because no "when" trigger is given it would overlap with the parent writing-plans skill for the same situations, so it could still conflict.

2 / 3

Total

7

/

12

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.

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