Guides subagent coordination through implementation workflows. Use when orchestrating multiple agents, managing workflow phases, or determining autonomous execution mode.
52
57%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/subagents-orchestration-guide/SKILL.mdQuality
Discovery
67%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 has good structural completeness with an explicit 'Use when' clause, but suffers from abstract, jargon-heavy language that lacks concrete specificity about what the skill actually does. The trigger terms lean technical rather than matching natural user language, and the domain could overlap with other workflow or project management skills.
Suggestions
Add concrete actions the skill performs, e.g., 'Assigns tasks to subagents, tracks completion status, handles inter-agent dependencies, and determines whether to run agents in parallel or sequentially.'
Include more natural trigger terms users might say, such as 'delegate tasks,' 'run in parallel,' 'multi-agent,' 'split work,' or 'coordinate subtasks.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (subagent coordination, implementation workflows) and some actions (orchestrating, managing workflow phases, determining execution mode), but the actions are fairly abstract rather than concrete. 'Guides subagent coordination' is vague about what specific coordination actions are performed. | 2 / 3 |
Completeness | Explicitly answers both 'what' (guides subagent coordination through implementation workflows) and 'when' (Use when orchestrating multiple agents, managing workflow phases, or determining autonomous execution mode). The 'Use when' clause is present with explicit triggers. | 3 / 3 |
Trigger Term Quality | Includes some relevant terms like 'subagent,' 'orchestrating multiple agents,' 'workflow phases,' and 'autonomous execution mode,' but these are somewhat technical/jargon-heavy. Users might more naturally say things like 'run tasks in parallel,' 'delegate work,' or 'multi-step workflow' which are missing. | 2 / 3 |
Distinctiveness Conflict Risk | The focus on 'subagent coordination' and 'autonomous execution mode' provides some distinctiveness, but 'managing workflow phases' and 'implementation workflows' are broad enough to potentially overlap with general project management or task planning skills. | 2 / 3 |
Total | 9 / 12 Passed |
Implementation
47%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a comprehensive orchestration guide with excellent workflow clarity — clear sequencing, explicit stop points, validation checkpoints, and well-defined feedback loops for error recovery. However, it suffers significantly from verbosity: the ~400-line document contains redundant explanations, over-specified handoff contracts, and detailed JSON field listings that could be dramatically condensed or split into reference files. The actionability is moderate — call examples are provided but rely on placeholders, and the guidance is more descriptive than executable.
Suggestions
Reduce the document by 40-60% by moving handoff contracts (HC-01 through HC-06) and structured response field specifications into a separate reference file, keeping only a summary table in the main SKILL.md.
Replace placeholder-based call examples with concrete, copy-paste-ready examples using realistic values (e.g., actual file paths like 'docs/plans/tasks/003-add-auth.md') to improve actionability.
Consolidate redundant escalation/stop-condition descriptions — escalation handling is described in at least three separate sections (Explicit Stop Points, Conditions for Stopping, Task Management cycle) and should be unified into one authoritative section with cross-references.
Split the monolithic file into SKILL.md (overview + quick reference tables + flow selection) plus reference files for detailed handoff contracts, response schemas, and the autonomous execution mode specification.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The document is extremely verbose at ~400+ lines with significant redundancy. Many sections repeat information (e.g., escalation handling is described in multiple places), and concepts like delegation boundaries and handoff contracts are over-explained. The structured response specification section lists JSON fields that subagents already know about. Much of this content describes orchestration concepts Claude could infer from shorter instructions. | 1 / 3 |
Actionability | The skill provides concrete call examples with subagent_type/description/prompt patterns and specific structured response fields to check. However, the examples use placeholders rather than fully executable invocations, the mermaid diagram is descriptive rather than executable, and many instructions remain at the level of 'pass X to Y' without showing exact prompt construction. The handoff contracts are specific but still somewhat abstract. | 2 / 3 |
Workflow Clarity | The multi-step workflows are clearly sequenced with explicit validation checkpoints. The autonomous execution mode has a detailed flow diagram, the 4-step task cycle has clear branching logic for each status response, the planning flows per scale are tabulated, and explicit stop points are defined with user actions required. Feedback loops (stub_detected → re-execute, blocked → escalate, needs_revision → retry) are well-specified with pass/fail criteria for post-implementation verification. | 3 / 3 |
Progressive Disclosure | The skill references `references/monorepo-flow.md` for fullstack flows and mentions other skills like documentation-criteria, but no bundle files are provided to verify these exist. The document itself is monolithic — the handoff contracts, structured response specifications, and detailed flow descriptions could be split into separate reference files. The single-file approach creates a wall of text that would benefit from better content splitting. | 2 / 3 |
Total | 8 / 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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
68ecb4a
Table of Contents
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.