CtrlK
BlogDocsLog inGet started
Tessl Logo

subagent-driven-development

Use when executing implementation plans with independent tasks in the current session or facing 3+ independent issues that can be investigated without shared state or dependencies - dispatches fresh subagent for each task with code review between tasks, enabling fast iteration with quality gates

75

Quality

68%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

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

Quality

Discovery

75%

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 strong on completeness and distinctiveness, clearly stating when to use the skill and carving out a unique niche for parallel independent task execution via subagents. However, it could improve in specificity of concrete actions and in using more natural user-facing trigger terms rather than internal architectural language like 'subagent' and 'quality gates'.

Suggestions

Add more natural trigger terms users might say, such as 'parallel tasks', 'batch work', 'multiple independent changes', or 'run tasks simultaneously'

Make the concrete actions more specific — e.g., 'breaks implementation plans into independent subtasks, executes each in a separate subagent, and performs code review after each completion' rather than the more abstract 'enabling fast iteration with quality gates'

DimensionReasoningScore

Specificity

The description mentions 'executing implementation plans', 'dispatching subagents', and 'code review between tasks', which names the domain and some actions, but the core actions are somewhat abstract — 'dispatches fresh subagent' and 'enabling fast iteration with quality gates' are more architectural descriptions than concrete user-facing actions.

2 / 3

Completeness

The description explicitly answers both 'what' (dispatches fresh subagents for each task with code review between tasks) and 'when' (when executing implementation plans with independent tasks or facing 3+ independent issues without shared state). The 'Use when' clause is present and provides clear trigger conditions.

3 / 3

Trigger Term Quality

Includes some useful trigger terms like 'independent tasks', 'implementation plans', '3+ independent issues', and 'subagent', but misses common natural language variations users might say such as 'parallel tasks', 'batch processing', 'run multiple tasks', or 'divide and conquer'. The language leans more technical/internal than user-facing.

2 / 3

Distinctiveness Conflict Risk

The description carves out a clear niche — parallel/independent task execution via subagents with quality gates. The specificity of '3+ independent issues', 'no shared state or dependencies', and 'fresh subagent for each task' makes it unlikely to conflict with other skills like single-task execution or sequential planning skills.

3 / 3

Total

10

/

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 good validation checkpoints and clear decision criteria for sequential vs parallel execution. Its main weaknesses are moderate verbosity (redundancy between parallel execution and parallel investigation sections), template-style rather than fully executable examples, and a long single-file format that could benefit from splitting into referenced sub-files. The real-world example and common mistakes sections add genuine value.

Suggestions

Make the Task tool dispatch examples more concrete by specifying the actual tool API or exact syntax Claude should use, rather than illustrative YAML blocks

Consolidate the 'Parallel Execution Process' and 'Parallel Investigation Process' sections to reduce redundancy, or split the investigation process into a separate referenced file

Provide the referenced bundle files (requesting-code-review/code-reviewer.md, finishing-a-development-branch) or clarify how Claude should locate them

DimensionReasoningScore

Conciseness

The skill is moderately verbose with some redundancy between sections (e.g., the parallel execution process and parallel investigation process overlap significantly). The 'Executing Plans through agents' bullet list restates what's already clear. However, most content is instructional rather than explanatory, and it avoids explaining basic concepts Claude would know.

2 / 3

Actionability

The skill provides structured prompts and workflow steps, but they are pseudocode/template-style rather than truly executable. The Task tool invocations use illustrative YAML-like blocks rather than copy-paste-ready commands. The agent prompt examples are concrete and useful, but the core dispatch mechanism is described abstractly (e.g., 'Task tool (general-purpose)' without specifying the actual tool API).

2 / 3

Workflow Clarity

The sequential execution process has clear numbered steps with explicit validation checkpoints (code review after each task, fix critical issues before proceeding, final review). The parallel process includes batch checkpoints and clear stop conditions. Red flags and 'When NOT to Use' sections provide good guardrails. Feedback loops are explicit (review → fix → verify).

3 / 3

Progressive Disclosure

The skill references external files (requesting-code-review/code-reviewer.md, finishing-a-development-branch skill) but no bundle files are provided to support these references. The content is quite long (~300 lines) and could benefit from splitting the parallel investigation section into a separate file. The structure within the file is reasonable with clear headers, but it's borderline monolithic.

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
NeoLabHQ/context-engineering-kit
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.