CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-orchestration-skill

Triggers when the master Agent faces a multi-step complex task and is deciding whether / how to outsource sub-tasks to built-in subagents (browser / doc-editor / data-analyst / extractor / canvas-designer / coder, etc.). **Not for**: single-step Q&A / reads / simple side effects (master Agent handles directly), or scenarios where `Agent` is already confirmed and `subagent_type` is known.

67

Quality

84%

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

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 well-structured, table-driven orchestration reference with concrete invocation syntax and explicit system limits. It loses points for triple-stating the anti-delegation rule, placeholder prompts in every example, and lacking failure-recovery guidance for the output-error state it names.

Suggestions

State the "don't delegate simple tasks" rule once (keep it in the Delegation Decision section) and remove the repetition in the prose paragraph and Common Misjudgments to tighten conciseness.

Replace the elided "prompt": "..." placeholders in the Agent and SendMessage examples with one complete realistic prompt so the invocation examples are fully copy-paste ready.

Add a short recovery step for the named output-error state (e.g., when a subagent fails: re-issue via SendMessage or fall back to handling directly), closing the workflow_clarity validation gap.

DimensionReasoningScore

Conciseness

The body is dense and table-driven, assuming Claude's competence, but the "don't delegate simple tasks" rule is stated three times (decision tree, prose paragraph, and Common Misjudgments) and the opening sentence re-states the tool's purpose — minor over-explanation that could be trimmed, matching anchor 4 rather than the every-token-earns-its-place anchor 5.

4 / 5

Actionability

Copy-paste-ready Agent and SendMessage invocation blocks, parameter tables, a subagent_type mapping table, and a hard-limits table give mostly executable guidance; however every example prompt is elided as "..." placeholder text, a minor gap versus anchor 5's requirement that specific examples cover the common cases.

4 / 5

Workflow Clarity

The delegation decision tree gives a clear sequenced flow (message → route → subagent type → invoke → aggregate) and error states are named ("output-error"), but no guidance exists for recovering from a failed subagent and there are no checkpoints — anchor 4 (clear sequence, minor validation gaps) rather than anchor 5's explicit feedback loops.

4 / 5

Progressive Disclosure

The skill is a single self-contained file with well-organized sections and tables, and no bundle files exist; the ~125-line body exceeds the under-50-line simple-skill exception, and minor items (streaming event internals, subagent capability tables) could live in one-level-deep references — good structure with minor organization gaps, matching anchor 4.

4 / 5

Total

16

/

20

Passed

Description

87%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 strong description with an explicit trigger clause, concrete negative boundaries, and named subagent targets in third-person voice. The main residual gap is that the skill's own actions (invoke, follow up, fan out) are only implied, and a few natural synonyms ("delegate", "dispatch") are absent.

DimensionReasoningScore

Specificity

The description names the delegation domain and enumerates six concrete subagent targets ("browser / doc-editor / data-analyst / extractor / canvas-designer / coder") plus explicit exclusion cases, but does not enumerate the skill's own concrete actions (invoking Agent, SendMessage follow-ups, parallel fan-out) — several specifics with minor coverage gaps, matching anchor 4 rather than a comprehensive anchor-5 list.

4 / 5

Completeness

It explicitly answers both questions: what ("deciding whether / how to outsource sub-tasks to built-in subagents") and when, with a concrete positive trigger ("Triggers when the master Agent faces a multi-step complex task") and an explicit "**Not for**:" exclusion clause — the 'when' is more explicit than anchor 4's 'could be more specific'.

5 / 5

Trigger Term Quality

Good natural-keyword coverage: "multi-step complex task", "outsource sub-tasks", the six subagent names, and "single-step Q&A / reads" as negative triggers; a few natural synonyms users might say ("delegate", "dispatch", "fan out") are missing, so it sits at anchor 4 rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (delegation decision-making for the Agent tool) and the explicit "Not for" boundaries fence off single-step tasks and cases where the Agent call is already confirmed, minimizing overlap with skills for the individual subagents.

5 / 5

Total

18

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

itsablabla/openloaf-web

Path

apps/server/src/ai/builtin-skills/agent-orchestration/en/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.