CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

subagents-orchestration-guide

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

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/subagents-orchestration-guide/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

60%Weight 40%Scale 1-5

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

A thorough orchestration procedure with unusually concrete routing guidance, explicit validation gates, and a real, well-signaled one-level-deep reference bundle. Its main weakness is token efficiency: heavy redundancy across sections and convoluted justification prose roughly double the body's length without adding guidance, which also drags down how easily the otherwise clear workflows can be followed.

Suggestions

Consolidate the requirement-change rules, which currently appear in 'Requirement Change Detection During Flow', 'Requirement reopening after codebase analysis', 'Handling Requirement Changes', the stop-conditions table, and Commit Boundary Check, into a single authoritative section that the other spots reference in one line.

Trim rationale justification sentences (e.g., 'because a classification produced by an analyzer is inference presented in the same object as observation') to short parenthetical notes, or move them to a reference file; keep the body to directives only.

Move the HC-01 through HC-06 handoff contracts and the post-implementation fix-cycle/re-run rules into a dedicated reference file (like monorepo-flow.md), keeping SKILL.md to the role, scale determination, stop points, and execution cycle.

DimensionReasoningScore

Conciseness

While it never explains concepts Claude already knows, the body restates requirement-change rules across many sections ("Requirement Change Detection During Flow", "Requirement reopening after codebase analysis", "Handling Requirement Changes", the stop-conditions table, and Commit Boundary Check) and pads rules with justification prose ("This output discipline supersedes general-purpose prompt self-containment because added context competes..."). This is noticeably verbose with several redundant sections rather than merely 'could be tightened', so it sits below the 3-anchor.

2 / 5

Actionability

For an instruction-only skill the guidance is highly concrete: exact field names ("task_file", "diffBase", "changedTestFiles", "correction_findings"), exact status branches ("stub_detected", "verification_incomplete", "needs_revision"), a commit-trailer template, and a mermaid execution cycle. It misses the 5-anchor because several steps depend on definitions outside the bundle ("the requirement-convergence skill", "documentation-criteria" Choice/Durability filters), leaving small execution gaps.

4 / 5

Workflow Clarity

Sequencing is explicit (per-scale planning flows, the numbered per-task 4-step cycle with branch-on-result substeps) and validation checkpoints are comprehensive (stop-point approval table, quality-fixer pass gate, reviewer verdict routing, fix-cycle and re-run rules with feedback loops). It falls short of the 5-anchor because dense cross-referencing — repeated 'Apply Specialist Result Acceptance' deferrals and rules spread across many sections — makes some transitions hard to track without re-reading.

4 / 5

Progressive Disclosure

All three referenced files (monorepo-flow.md, review-resolution.md, lite-mode.md) exist, are substantive, one level deep, and are signaled both at point of use and in a References section with one-line purposes. It is not the 5-anchor because substantial deep detail — the HC handoff contracts and fix-cycle/re-run rules — is inlined in SKILL.md where a reference file would fit, leaving minor organization gaps.

4 / 5

Total

14

/

20

Passed

Description

78%Weight 40%Scale 1-5

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 concise, well-formed description that clearly states what the skill does and gives three explicit 'Use when' triggers in third person. Its main limitation is that the 'what' is a single abstract action rather than a list of concrete capabilities, leaving a reader to infer scope from the triggers.

DimensionReasoningScore

Specificity

Names the domain ("Guides subagent coordination through implementation workflows") but the stated action is abstract; it does not list several concrete operations like the 4-anchor requires. It clears the 3-anchor ('names domain and 1-2 concrete actions') because the trigger clause adds concrete activities such as "determining autonomous execution mode".

3 / 5

Completeness

It 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") with concrete trigger phrases. The 4-anchor's caveat ('when could be more explicit or specific') does not apply since the when-clause lists three explicit conditions.

5 / 5

Trigger Term Quality

"orchestrating multiple agents", "managing workflow phases", and "autonomous execution mode" are natural phrases a user of this domain would say, giving good keyword coverage. It falls short of the 5-anchor because common variants like "multi-agent", "delegation", or "agent teams" are missing.

4 / 5

Distinctiveness Conflict Risk

The subagent-orchestration niche is clear and mostly distinct, with specific triggers. It is not the 5-anchor because broad terms like "workflow phases" and "multiple agents" carry minor overlap risk with general agent-team or workflow skills.

4 / 5

Total

16

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

shinpr/claude-code-workflows

Path

skills/subagents-orchestration-guide/SKILL.md

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.