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 ./src-tauri/experts/skills/subagent-driven-development/SKILL.md

The canonical home for this skill is subagent-driven-development in obra/superpowers

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 excels at workflow clarity — a complete, loop-validated process with status handling and a red-flags checklist — and its guidance is largely concrete and non-obvious. Its two real weaknesses are the missing prompt-template files the workflow depends on (broken bundle references) and localized verbosity from the duplicated flowchart edges and a partly redundant Advantages section. Fixing the bundle and trimming the duplication would lift it substantially.

Suggestions

Add the three referenced prompt template files (implementer-prompt.md, spec-reviewer-prompt.md, code-quality-reviewer-prompt.md) to the bundle or inline their contents — the core dispatch workflow currently points at files that do not exist.

Remove the duplicated edge statements in the process dot-graph (the edge list repeats every node label verbatim) and trim the Advantages section, which restates points already made in 'When to Use' and the opening.

Consider moving the 70-line Example Workflow transcript into a separate reference file so SKILL.md stays a lean overview, matching the progressive-disclosure structure the skill already gestures at.

DimensionReasoningScore

Conciseness

The body is mostly purposeful — status handling, model selection, and red flags are non-obvious guidance — but the process dot-graph duplicates its entire node list as edge labels (~19 redundant lines), the Advantages section restates points from 'When to Use' and the intro, and the example transcript runs long. This is 'mostly efficient but could be tightened' (3) rather than 4, since the edge duplication and repeated comparisons are more than minor padding.

3 / 5

Actionability

Concrete guidance exists (four statuses with explicit handling steps, model-selection heuristics, a never-do checklist, worked example), but the core dispatch content — the three prompt templates — is referenced as './implementer-prompt.md' etc. and none of these files exist in the bundle, leaving the key executable detail missing. This is 'some concrete guidance but incomplete / missing key details' (3); the gap exceeds the 'minor gaps' of 4, while the in-body specificity rules out 2.

3 / 5

Workflow Clarity

The process is fully sequenced with explicit validation gates (spec review before quality review, final whole-implementation review), documented feedback loops ('Implementer fixes spec gaps' → re-review, repeated until approved), status-based decision branches, and a Red Flags checklist. This matches the anchor for clear sequence with explicit validation, error-recovery loops, and checklists; nothing is missing for 5.

5 / 5

Progressive Disclosure

Section structure is good and references are clearly signaled in a dedicated 'Prompt Templates' section, but the three referenced files do not exist in the bundle (no references/ directory), so navigation is broken, and the 70-line example transcript is inlined where a separate file could carry it. This lands at 3 ('some structure but could be better organized'); broken references exceed the 'minor organization gaps' of 4, while the solid section structure and one-level reference design rule out 2.

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 well-formed trigger clause but is only half a description: it says when to use the skill without saying what the skill does. Users searching for subagent delegation or plan-execution help may not surface it, and it risks confusion with the executing-plans alternative it must be distinguished from. Adding one sentence of concrete capabilities (fresh subagent per task, spec-compliance then code-quality review) would materially improve it.

Suggestions

Add a 'what' clause describing concrete capabilities, e.g. 'Executes each task via a fresh implementer subagent, followed by spec-compliance and code-quality review subagents. Use when executing implementation plans with independent tasks in the current session.'

Include trigger synonyms users would actually say, such as 'implement this plan,' 'run the plan tasks,' or 'execute tasks with subagents,' to improve trigger_term_quality.

Differentiate explicitly from the parallel-session alternative, e.g. '...in the current session (versus dispatching a separate session),' to reduce conflict risk with executing-plans-style skills.

DimensionReasoningScore

Specificity

The description names its domain ("executing implementation plans with independent tasks") but lists no concrete actions — no mention of dispatching subagents, two-stage review, or any capability. It matches 'Names the domain but actions are minimal or generic'; it is not a 3 because zero concrete actions are stated, and not a 1 because the domain is clearly identified.

2 / 5

Completeness

The 'when' is explicit ("Use when executing implementation plans with independent tasks in the current session") but the 'what' — what the skill actually does — is entirely absent. This mirrors anchor 2 ('only when is present without what', e.g. "Use when working with documents"); it cannot be a 3 or 4 because no capability is described at all.

2 / 5

Trigger Term Quality

"executing implementation plans" and "independent tasks" are phrases users would naturally say, but coverage is thin — missing variations like "implement the plan," "run the plan tasks," or "subagents." Some relevant keywords with common variations missing matches anchor 3; it lacks the breadth of coverage expected at 4.

3 / 5

Distinctiveness Conflict Risk

The description is somewhat specific ("implementation plans," "independent tasks," "current session") but overlaps materially with sibling plan-execution skills — the body itself names superpowers:executing-plans as an alternative, and a user could not reliably distinguish them from the description alone. Anchor 3 fits; overlap is more than minor, ruling out 4, but the domain is not broad enough to be 2.

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

arwei944/codeg

Path

src-tauri/experts/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.