CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-orchestration-skill

当主 Agent 面临多步骤复杂任务并正在判断要不要 / 怎样把子任务外包给内置子代理(browser / doc-editor / data-analyst / extractor / canvas-designer / coder 等)时触发。**不用于**:单步问答 / 读取 / 简单副作用(主 Agent 直接做)、已经明确要用 `Agent` 且知道 subagent_type 的场景。

63

Quality

79%

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 ./apps/server/src/ai/builtin-skills/agent-orchestration/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

68%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, actionable orchestration reference: routing is unambiguous, call syntax is concrete, and system constraints are explicit. Its main weakness is the absence of validation/error-recovery checkpoints around subagent results, particularly in the batch parallel fan-out workflow, plus some duplicated routing content.

Suggestions

Add an explicit verification loop to the 并行扇出-汇总 workflow: after results return, check each stream's terminal state (output-error → correct via SendMessage or re-dispatch) before summarizing, and include one concrete recovery example.

Replace the "..." prompt placeholder in the Agent call example with one complete, well-formed delegation prompt so the expected instruction quality is concrete.

Consolidate the subagent routing logic that currently appears in three places (委派决策 tree, 六个内置子代理 table, 常见误判) to remove duplication and cut tokens.

DimensionReasoningScore

Conciseness

The body is dense and information-rich — routing tables, call syntax, and hard limits with almost no concept-explanation padding ("委派本身会引入上下文传递开销和额外步数,小任务得不偿失" earns its place). Subagent routing appears three times (委派决策 tree, 六个内置子代理 table, 常见误判), which is minor duplication that could be trimmed, keeping it below the 'every token earns its place' anchor.

4 / 5

Actionability

Concrete, mostly executable guidance: exact call skeletons ("Agent { description: \"爬取 A 站产品表\", prompt: \"...\", subagent_type: \"browser\" }", "SendMessage { toolCallId: \"agent-xxx\", message: ... }") plus parameter tables and specific limits (depth 2, concurrency 4). Minor gaps: prompt fields are "..." placeholders with no example of a well-formed delegation prompt, and no guidance for handling the "output-error" state it names.

4 / 5

Workflow Clarity

Sequences are clear (decision tree; fan-out "拆解任务 → 并行发出 → 各自同步返回 → 汇总") but validation checkpoints are absent — the state flow "output-streaming → output-available | output-error" is mentioned with no recovery step, and the batch parallel fan-out workflow includes no verification of subagent results before summarizing. Per the rubric, missing validation in a batch operation caps this at 3.

3 / 5

Progressive Disclosure

Well-sectioned single-file skill (~125 lines) with clear headers (工具清单, 委派决策, 六个内置子代理, Agent 工具调用, SendMessage, 并行扇出-汇总, 上下文继承, 系统硬限制, 常见误判) and no nested or buried references. It exceeds the 50-line simple-skill threshold and some reference-grade tables could live in a separate file, so it is not a 5, but structure and placement are good.

4 / 5

Total

15

/

20

Passed

Description

82%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 trigger-focused description: it explicitly defines both the positive trigger condition and negative exclusions, names all six subagents, and carves out a distinct niche. Its only weakness is that it stays at the trigger layer without enumerating the skill's concrete capabilities.

DimensionReasoningScore

Specificity

The description names the domain and concrete targets ("把子任务外包给内置子代理(browser / doc-editor / data-analyst / extractor / canvas-designer / coder 等)") but states only that one action — it does not enumerate what the skill covers (call format, parallel fan-out, SendMessage, system limits). Matches 'names domain and 1-2 concrete actions, but not comprehensive'; not 4 because several specific capabilities are absent, not 2 because the domain and targets are specific rather than generic.

3 / 5

Completeness

Explicitly answers both: what ("判断要不要 / 怎样把子任务外包给内置子代理") and when, with a concrete positive trigger ("当主 Agent 面临多步骤复杂任务并正在判断要不要 / 怎样把子任务外包给...时触发") plus explicit negative triggers ("**不用于**:单步问答 / 读取 / 简单副作用...、已经明确要用 Agent 且知道 subagent_type 的场景"). Both are concrete and explicit.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "多步骤复杂任务", "子任务", "外包", "子代理", plus all six subagent names users would actually mention. A few natural terms are missing (e.g. "并行/parallel", "fan-out", "委派"), so it falls short of the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

Clear niche (delegation-to-subagents decision) with distinct triggers and explicit exclusions — the "不用于" clause and the exclusion of cases where "已经明确要用 Agent 且知道 subagent_type" sharply reduce the risk of firing for the wrong skill. Voice is third person ("当主 Agent 面临...时触发"), so no voice penalty applies.

5 / 5

Total

17

/

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