CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

subagent-driven-development

Use when executing implementation plans with independent tasks in the current session

Quality

59%

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/subagent-driven-development/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

62%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 delivers an unusually clear, well-gated workflow with explicit review loops and checklists, and the status/model-selection guidance is genuinely actionable. However, all three referenced prompt-template files are missing from the bundle, which hollows out the core dispatch step, and the dot-graph redundancy plus the self-justification 'Advantages' section spend tokens without adding instructional value. Restoring the bundle files and trimming the graphs would raise this from good to excellent.

Suggestions

Add the three missing prompt-template files (implementer-prompt.md, spec-reviewer-prompt.md, code-quality-reviewer-prompt.md) to the bundle, or inline their essential content — the dispatch step currently resolves to nothing.

Replace the raw dot digraphs with a concise numbered step sequence; dot source is token-heavy, partially redundant, and does not render as markdown.

Trim the 'Advantages', 'Efficiency gains', and 'Cost' subsections to a couple of lines or remove them — a skill that is already triggered does not need to persuade Claude of its merits.

DimensionReasoningScore

Conciseness

The operational sections (Model Selection, Handling Implementer Status, Red Flags, Integration) are dense and useful, but the two raw dot digraphs state edges redundantly and consume many tokens without rendering as markdown, and the ~30-line 'Advantages / Efficiency gains / Cost' section justifies the skill rather than instructing Claude. Matches 'Mostly efficient but includes some unnecessary explanation or could be tightened'.

3 / 5

Actionability

Status handling, model selection, and the worked example workflow are concrete and executable, but the skill's central repeated action — dispatching subagents — points to ./implementer-prompt.md, ./spec-reviewer-prompt.md, and ./code-quality-reviewer-prompt.md, none of which exist in the bundle. The key details for the dispatch step are missing, matching 'Some concrete guidance but incomplete; missing key details'.

3 / 5

Workflow Clarity

The process is fully sequenced per task (dispatch → questions → implement/test/commit/self-review → spec review → fix → re-review → quality review → fix → re-review → mark complete) with explicit feedback loops ('Repeat until approved', 're-review' edges), explicit validation checkpoints at three levels (spec compliance, code quality, final review), an explicit ordering rule ('Start code quality review before spec compliance is ✅' listed as a Never), and the Red Flags Never-list acting as a checklist. Matches 'Clear sequence with explicit validation steps; feedback loops for error recovery; checklists for complex processes'.

5 / 5

Progressive Disclosure

The in-body design is good — a dedicated 'Prompt Templates' section signals all three referenced files with one-line descriptions, and references are one level deep — but the actual bundle contains none of them (no references/, scripts/, or assets/ directories, no prompt .md files), so every referenced path is dangling and the disclosure structure cannot function. This sits between 'references present but not clearly signaled' (they are signaled) and 'good structure' (broken delivery), landing at 3.

3 / 5

Total

14

/

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 pure trigger clause with a reasonably specific 'when' but completely missing the 'what', so a reader cannot tell what the skill does or how it differs mechanically from plain plan execution. Trigger vocabulary is relevant but sparse and lacks natural synonyms. Adding a concrete capability statement would move both specificity and completeness up two levels.

Suggestions

Add a 'what' clause describing the concrete mechanism, e.g.: 'Dispatch a fresh subagent per task with two-stage review (spec compliance first, then code quality). Use when executing implementation plans with independent tasks in the current session.'

Broaden trigger terms with natural variations users would actually say, such as 'run the plan', 'work through the plan tasks', or 'execute the tasks in this plan'.

Make the distinction from the parallel-session alternative explicit in the description (e.g. '...in this session rather than a separate session') so it does not collide with an executing-plans skill.

DimensionReasoningScore

Specificity

The description names the domain ("executing implementation plans") but the only action is the generic verb "executing" — it never states what the skill actually does (dispatching fresh subagents per task, two-stage spec-then-quality review). This matches the anchor 'Names the domain but actions are minimal or generic' (cf. 'Processes PDF files').

2 / 5

Completeness

The description is entirely a 'when' clause ("Use when executing...") with no 'what' — the reader learns nothing about the subagent-dispatch and two-stage-review mechanism. Exact match to the anchor 'only when is present without what'. Not 3, because anchor 3 requires a clear 'what', which is absent.

2 / 5

Trigger Term Quality

"executing implementation plans" and "independent tasks" are phrases a user might plausibly say, but coverage is thin: common variations like "run the plan", "work through the tasks", or "implement the plan" are missing, and "in the current session" is not a natural user utterance. Matches 'Some relevant keywords but missing common variations or synonyms'.

3 / 5

Distinctiveness Conflict Risk

The core trigger "executing implementation plans" overlaps directly with the sibling skill rubypowers:executing-plans (cited in the body as the alternative), and the differentiator "in the current session" is not a phrase users say, so mis-triggering between the two is plausible. Matches 'Somewhat specific but could still overlap with similar 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

lucianghinda/superpowers-ruby

Path

skills/subagent-driven-development/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.