CtrlK
BlogDocsLog inGet started
Tessl Logo

subagents-orchestration-guide

Guides subagent coordination through implementation workflows. Use when orchestrating multiple agents, managing workflow phases, or determining autonomous execution mode.

52

Quality

57%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/subagents-orchestration-guide/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.'

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
shinpr/claude-code-workflows
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.