CtrlK
BlogDocsLog inGet started
Tessl Logo

subagent-driven-development

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

41

Quality

40%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/subagent-driven-development/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

17%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This description is too vague and abstract to be effective for skill selection. It lacks concrete actions, natural trigger terms, and sufficient specificity to distinguish it from other execution-related skills. The 'Use when' clause is present but the overall content is too thin to guide Claude in selecting this skill appropriately.

Suggestions

Add specific concrete actions the skill performs, e.g., 'Parallelizes independent subtasks from a plan, executes them concurrently, and aggregates results' instead of the vague 'executing implementation plans'.

Include natural trigger terms users would say, such as 'run tasks in parallel', 'execute plan steps', 'concurrent execution', 'batch tasks', or 'parallelize work'.

Clarify what 'independent tasks' means and what types of implementation plans this applies to (e.g., coding tasks, file operations, API calls) to reduce conflict risk with other skills.

DimensionReasoningScore

Specificity

The description uses vague language like 'executing implementation plans' and 'independent tasks' without specifying any concrete actions. It does not list what specific operations or capabilities the skill provides.

1 / 3

Completeness

It has a 'Use when' clause addressing when to use the skill, but the 'what does this do' part is extremely weak — 'executing implementation plans with independent tasks' barely describes the actual capability. The 'when' is present but the 'what' is essentially missing.

2 / 3

Trigger Term Quality

The terms 'implementation plans' and 'independent tasks' are not natural phrases users would say. Users are more likely to say things like 'run tasks in parallel', 'execute my plan', or 'do these steps'. The language is abstract and jargon-heavy.

1 / 3

Distinctiveness Conflict Risk

'Executing implementation plans' is very generic and could overlap with many skills related to task execution, project management, code generation, or workflow automation. There are no distinct triggers that would clearly differentiate this skill.

1 / 3

Total

5

/

12

Passed

Implementation

62%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill provides a well-structured workflow for subagent-driven development with clear sequencing, validation checkpoints, and error handling paths. Its main weaknesses are verbosity (the Advantages and Red Flags sections add significant length) and incomplete actionability due to missing bundle files for the referenced prompt templates that are essential to executing the workflow. The Graphviz diagrams are a creative approach to workflow visualization but add substantial token overhead.

Suggestions

Provide the referenced prompt template files (implementer-prompt.md, spec-reviewer-prompt.md, code-quality-reviewer-prompt.md) as bundle files, since they are essential for executing this skill

Trim the 'Advantages' section significantly — most of these benefits are self-evident from the process description and don't add actionable guidance

Consolidate the 'Red Flags' section by removing items that duplicate the process description (e.g., review ordering is already clear from the workflow diagram)

Replace the Graphviz diagrams with concise numbered lists to reduce token overhead while maintaining clarity

DimensionReasoningScore

Conciseness

The skill contains useful information but is verbose in several areas. The 'Advantages' section extensively lists benefits that are somewhat redundant with earlier content. The Graphviz diagrams, while structured, add significant token overhead compared to a simple numbered list. The 'Red Flags' section repeats concepts already covered in the process description (e.g., review ordering). However, it does avoid explaining basic concepts Claude already knows.

2 / 3

Actionability

The skill provides a clear process and a detailed example workflow, but lacks concrete executable code or commands. References to prompt templates (./implementer-prompt.md, ./spec-reviewer-prompt.md, ./code-quality-reviewer-prompt.md) are critical for actionability but no bundle files are provided, making the skill incomplete. The example workflow is illustrative but presented as pseudo-conversation rather than executable steps. Model selection guidance is directional rather than specific (no actual model names or API calls).

2 / 3

Workflow Clarity

The multi-step process is clearly sequenced with explicit validation checkpoints (spec compliance review → code quality review), feedback loops (reviewer finds issues → implementer fixes → re-review), and clear handling of all implementer statuses (DONE, DONE_WITH_CONCERNS, NEEDS_CONTEXT, BLOCKED). The process diagram and example workflow make the sequence unambiguous, and the 'Red Flags' section explicitly calls out ordering constraints like not starting code quality review before spec compliance passes.

3 / 3

Progressive Disclosure

The skill references three prompt template files (implementer-prompt.md, spec-reviewer-prompt.md, code-quality-reviewer-prompt.md) and several related skills, which is good progressive disclosure structure. However, no bundle files are provided, so these references are unverifiable. The main file itself is quite long (~200+ lines) and could benefit from moving the 'Advantages' and 'Red Flags' sections to supplementary files, keeping the SKILL.md focused on the core process.

2 / 3

Total

9

/

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
lucianghinda/superpowers-ruby
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.