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.

64

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

77%

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

A dense, highly actionable orchestration guide with strong workflow sequencing, validation checkpoints, and feedback loops. Its main weakness is conciseness and progressive disclosure: the body is long with some redundancy and keeps reference-like material inline rather than splitting it into separate files.

Suggestions

Tighten the body by removing the 'Important Constraints: Recap' section and reconciling the prose planning-flow tables with the Mermaid diagram to eliminate overlap.

Extract the lengthy 'Structured Response Specification' and 'Handoff Contracts' subsections into a dedicated reference file, keeping SKILL.md an overview with clearly signaled one-level-deep links.

Trim enumerated structured-response field lists to only the fields the orchestrator must read for routing decisions.

DimensionReasoningScore

Conciseness

Mostly efficient and action-oriented with no concept-explaining fluff, but the body is long (~410 lines) with recap sections ('Important Constraints: Recap'), overlap between the prose flow tables and the Mermaid diagram, and verbose structured-response field enumerations that could be tightened. Not 1 because it never explains concepts Claude already knows; not 3 because it is not lean and clearly has room to tighten.

2 / 3

Actionability

Provides concrete, copy-paste-ready invocation templates (subagent_type/description/prompt call examples), explicit prompt-construction rules with [placeholder] substitution, named subagents, structured-response key fields, and a fixed permitted-tools list. Fully executable guidance rather than vague direction.

3 / 3

Workflow Clarity

Sequences are explicit per scale, with pass/fail criteria tables, a re-run rule for failed verifiers, feedback loops (stub_detected -> task-executor, needs_revision -> retry, verification fix cycle), escalation paths, and explicit stop points. Clear checkpoints and error-recovery loops throughout.

3 / 3

Progressive Disclosure

SKILL.md serves as an overview and offloads the fullstack flow to a real, clearly signaled one-level-deep reference (references/monorepo-flow.md, verified to exist). However, sizable reference-like content (handoff contracts, structured-response specs) is inline rather than split out. Not 3 because some content that could be separate remains inline; not 1 because references are not deeply nested and navigation is signaled.

2 / 3

Total

10

/

12

Passed

Description

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.

A clear, third-person description with an explicit 'Use when' trigger clause and a distinct niche. It is held back from a top score by somewhat abstract action verbs and slightly specialized trigger phrasing rather than broadly natural keywords.

DimensionReasoningScore

Specificity

Names the domain ('subagent coordination', 'implementation workflows') and some actions ('Guides', 'managing workflow phases', 'determining autonomous execution mode'), but the verbs are abstract rather than a list of concrete distinct actions. Not 3 because it lacks multiple specific concrete actions like 'extract/fill/merge'; not 1 because it does name a domain and actions.

2 / 3

Completeness

Explicitly states what it does ('Guides subagent coordination through implementation workflows') and when to use it via a 'Use when' clause with concrete triggers. Clearly answers both what and when; matches the anchor example structure.

3 / 3

Trigger Term Quality

Includes relevant natural-ish phrases ('orchestrating multiple agents', 'managing workflow phases') but leans on specialized jargon ('autonomous execution mode') and misses common variations users might say. Not 3 because coverage of natural terms is incomplete; not 1 because the keywords are relevant rather than purely technical or generic.

2 / 3

Distinctiveness Conflict Risk

Targets a clear niche (subagent orchestration, autonomous execution mode) with distinct triggers unlikely to fire for unrelated skills. Not 2 because the triggers are specific enough to avoid meaningful overlap.

3 / 3

Total

10

/

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.

Validation16 / 16 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.