Agent skill

Agent Orchestration Skill

by OpenLoaf in OpenLoaf/OpenLoaf

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

AGPL-3.0Auto-check passedAgent Workflows

Install Agent Orchestration Skill

skills CLI
$ npx skills add OpenLoaf/OpenLoaf --skill agent-orchestration-skill -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install OpenLoaf/OpenLoaf agent-orchestration-skill --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/OpenLoaf/OpenLoaf.git skills-src && mkdir -p .claude/skills && cp -r skills-src/apps/server/src/ai/builtin-skills/agent-orchestration .claude/skills/agent-orchestration-skill && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
agent-orchestration-skill
GitHub stars
108
Token cost
~919 tokens
SKILL.md length
217 words
Files
1
Skills in repo
33
Repo updated
First seen
Licence
AGPL-3.0

At a glance

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

  • Tasks that involve Multi-agent orchestration
  • SKILL.md covers 工具清单, 委派决策, 六个内置子代理 and Agent 工具调用, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve Data analysis

What it does

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

Its SKILL.md is about 920 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Multi-agent orchestration, Data analysis and Subagents. The repository describes itself as: 🍞Open-source, local-first AI workspace with Agents, multi-model chat (GPT/Claude/Gemini/DeepSeek), Notion-like docs, AI image & video generation, email, calendar & terminal…. The licence is AGPL-3.0.

When your agent uses it

  • Tasks that involve Multi-agent orchestration
  • Tasks that involve Data analysis
  • Tasks that involve Subagents

Example prompts

  • “/agent-orchestration-skill”

What it can do on your machine

Read from SKILL.md and the folder at commit f7eccf6. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Agent Orchestration Skill loads about 919 tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 217 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~57
When it runs · the whole SKILL.md, loaded when a task matches
~919

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from OpenLoaf/OpenLoaf at commit f7eccf6, republished under its AGPL-3.0 licence (© OpenLoaf). 217 words, ~919 tokens.

Download SKILL.mdSave it as .claude/skills/agent-orchestration-skill/SKILL.md (or your agent's skills folder).
name
agent-orchestration-skill
description
当主 Agent 面临多步骤复杂任务并正在判断要不要 / 怎样把子任务外包给内置子代理(browser / doc-editor / data-analyst / extractor / canvas-designer / coder 等)时触发。**不用于**:单步问答 / 读取 / 简单副作用(主 Agent 直接做)、已经明确要用 `Agent` 且知道 subagent_type 的场景。
version
5.0.0
tools
Agent

子代理委派与 Agent 工具

主 Agent 可以通过 Agent 工具按需调度内置或自定义子代理,把专业子任务外包出去。本 skill 回答四个问题:何时委派、委派给谁、怎么调用、系统约束是什么。

工具清单

工具职责只读
Agent按 subagent_type 启动内置或自定义子代理处理多步复杂任务否

加载:Agent 为核心工具,始终可用,无需 ToolSearch 激活。

委派决策

用户消息 →
  ├─ 简单问答 / 闲聊 / 读取 / 查询 / 单步副作用(创建事件、发邮件、建项目)→ 主 Agent 直接做
  └─ 多步骤复杂任务 →
      ├─ 网页交互(点击/填表/登录/截图/翻页抓取)→ browser
      ├─ 富文本 / 长文档编辑(Markdown、DOCX、PDF)→ doc-editor
      ├─ 表格数据分析 / 图表生成 → data-analyst
      ├─ PDF / 图片 / 网页结构化提取 → extractor
      ├─ 画布节点操作 / 布局 → canvas-designer
      ├─ 代码编写 / 调试(仅全局模式;项目模式下 PM 自己做)→ coder
      └─ 混合任务 → 主 Agent 拆解后依次或并行委派多个子代理

别"什么都委派":简单问答、单步操作、纯读任务用主 Agent 直接做。委派本身会引入上下文传递开销和额外步数,小任务得不偿失。

六个内置子代理

每个子代理都有独立的 system prompt 和工具集,步数按任务性质调整。

子代理触发时机工具集步数
📝 doc-editor富文本/Markdown/Word/PDF 编辑,长文档改写Write, Read, Glob15
🌐 browser页面导航、DOM 交互、表单填写、截图、翻页抓取browser-*, WebSearch20
📊 data-analystCSV/Excel 清洗、统计计算、ECharts/Mermaid 图表Read, Write, Bash15
🔍 extractorPDF/图片 OCR、表格抽取、多文档对比提取Read, office-read, WebFetch10
🎨 canvas-designer节点增删改、自动布局、文本到画布转换canvas-*, canvas-read15
💻 coder多语言代码编写/审查/调试Write, Read, Grep, Glob, Bash20

Agent 工具调用

Agent { description: "爬取 A 站产品表", prompt: "...", subagent_type: "browser" }
参数作用
description短标题,向用户展示进度
prompt交给子代理的完整指令
subagent_type子代理类型
subagent_type场景能力
general-purpose通用任务(默认)完整工具集
explore代码库/文档探索、只读分析只读工具
plan方案设计、输出实现计划只读工具
上表 6 个内置子代理名专业任务各子代理定义的工具集
自定义 Agent 名称已注册的专业 AgentAgent 定义的工具集

Agent 工具默认同步等待子代理完成并返回结果——调用后直接拿到输出继续下一步,不需要额外的等待工具。

SendMessage:追加指令

子代理已创建但需要追加指令或修正方向时:

SendMessage { toolCallId: "agent-xxx", message: "补充要求:结果用 JSON 格式输出" }

SendMessage 自动恢复已停止的 agent,不需要重新 Agent 创建,避免重新传递完整上下文的开销。

并行扇出-汇总

子任务互不依赖时,在同一轮内同时发出多个 Agent 调用,各自同步返回后主 Agent 汇总:

主 Agent 拆解任务 → 并行发出:
  Agent { description: "爬 A 站", subagent_type: "browser", prompt: "..." }
  Agent { description: "爬 B 站", subagent_type: "browser", prompt: "..." }
  Agent { description: "爬 C 站", subagent_type: "browser", prompt: "..." }
  ↓ 各自同步返回 A / B / C
主 Agent 汇总 → 最终回复

能并行:子任务独立、并行能显著缩短总耗时。 不能并行:后任务依赖前任务的输出(串行依赖);总数超过并发上限 4 需要分批。

上下文继承

子代理自动继承主 Agent 的:

  • projectId —— 同一项目沙箱,路径权限和文件访问一致
  • pageContext 对应的 skill —— 子代理看得到相同的能力认知(主 Agent 在 email 页创建 extractor,后者也看得到 email-ops)
  • 临时项目路径 —— 如果主 Agent 已创建临时项目,子代理共享该目录

这意味着你不需要在 prompt 里重复传递环境信息,子代理能从继承的上下文推导。

系统硬限制

限制值原因
最大委派深度2(主 → 子,子不可再 spawn)每级复制上下文,层级越深 token 消耗指数增长;也避免级联失败难以定位
最大并发4 个子代理响应速度与系统资源(内存、API 连接)的平衡点
自动清理5 分钟完成后的 Agent 自动从内存删除,避免累积泄漏
步数硬限Master 200 / Sub 10-20Sub 按上表列出,Master 有更大余量处理协调工作

子代理的流式输出通过 data-sub-agent-start / delta / chunk / end 事件推送前端,每个 toolCallId 对应一条独立流,支持多个并发子代理同时流式输出。状态流转:output-streaming → output-available | output-error。

常见误判

  • 别层级嵌套:子代理不能再 spawn 子代理。需要更深层级时重新拆解,让主 Agent 按顺序调用多个子代理。
  • 别用错类型:要页面交互选 browser,只需读静态页用 WebFetch(主 Agent 自己就能调);要 OCR 选 extractor,要精确 DOM 操作选 browser。
  • 别在已有子代理时重新 Agent:用 SendMessage 追加指令,复用已有上下文。
  • 别把简单任务委派出去:一次读取、一次查询、一次创建——主 Agent 自己做比委派快得多。

© OpenLoaf, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in apps/server/src/ai/builtin-skills/agent-orchestration of OpenLoaf/OpenLoaf.

Open the folder on GitHubat commit f7eccf6

Compare with similar skills

Agent Orchestration Skill next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Agent Orchestration Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agent Orchestration Skill this skillOpenLoaf/OpenLoaf108—~919Automated safety check: PassAGPL-3.0
WavesRayFernando1337/rayfernando-skills130—~9.7kAutomated safety check: PassApache-2.0
Paseo Advisor Second Opiniongetpaseo/paseo20k1 repos~756Automated safety check: PassCustom licence
O2 Review Loopopenobserve/openobserve22k—~3.7kAutomated safety check: PassAGPL-3.0
Harness Agent Team Designerrevfactory/harness9.1k—~4.5kAutomated safety check: PassApache-2.0
ClawTeam Multi-Agent Swarmwin4r/ClawTeam-OpenClaw1.5k1 repos~2.9kAutomated safety check: PassMIT

Similar skills

  • Waves

    RayFernando1337/rayfernando-skills

    WAVES — Workers · Aggregate · Verify · Extend — wave-based orchestration for Cursor.

    130 GitHub stars~9.7k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Launches one separate agent through Paseo to give a second opinion on the current task, with a self-contained briefing and no permission to edit files.

    20k GitHub starsUsed in 1 repo~756 tokens
    Agent WorkflowsAuto-check passed
  • O2 Review Loop

    openobserve/openobserve

    Splits a change into planner, coder and independent reviewer roles: you confirm a spec, a subagent implements it, and a separate reviewer checks each round's local WIP commit.

    22k GitHub stars~3.7k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Harness Agent Team Designer

    revfactory/harness

    Designs a project-specific agent harness: defines specialist agents, writes the skills they follow, picks an execution mode and model for each, and keeps the setup maintained.

    9.1k GitHub stars~4.5k tokensUpdated 11 days ago
    Agent WorkflowsAuto-check passed
  • ClawTeam Multi-Agent Swarm

    win4r/ClawTeam-OpenClaw

    Launches a swarm of specialist Hermes agents in git-worktree-isolated tmux windows with a kanban board and file-based inboxes, using built-in templates like hedge-fund and code-review.

    1.5k GitHub starsUsed in 1 repo~2.9k tokens
    Agent WorkflowsAuto-check passed
  • Sub-Agent Delegation

    codewhale-hq/Codewhale

    Guides when and how to split multi-step coding, research or verification work into focused sub-agent runs while the parent keeps integration and final checks.

    41k GitHub stars~790 tokensUpdated today
    Agent WorkflowsAuto-check passed

More from OpenLoaf/OpenLoaf

All 33 skills in this repo
  • Agent Orchestration Skill

    OpenLoaf/OpenLoaf

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

    108 GitHub stars~1.9k tokensUpdated 4 mo ago
    Auto-check passed
  • Browser Ops Skill

    OpenLoaf/OpenLoaf

    Triggered when the user asks for page-level interaction with a specific webpage: login, form filling, button clicks, pagination scraping, screenshots, downloading page images, handling CAPTCHAs or…

    108 GitHub stars~1.5k tokensUpdated 4 mo ago
    Auto-check passed
  • Canvas Ops Skill

    OpenLoaf/OpenLoaf

    Triggered when the user wants lifecycle management of OpenLoaf canvases / whiteboards: create, open, filter, duplicate, delete, rename, or change ownership.

    108 GitHub stars~1.4k tokensUpdated 4 mo ago
    Auto-check passed
  • Reads, edits, converts and reviews Word documents through three dedicated tools, covering tracked changes, comments, tables, images and format conversion.

    108 GitHub stars~1.9k tokensUpdated 4 mo ago
    Auto-check passed
  • Email Operations

    OpenLoaf/OpenLoaf

    Handles a real email account through query and mutate tools: check the inbox, read, search, reply, forward, compose and organize, with sending always confirmed first.

    108 GitHub stars~1.8k tokensUpdated 4 mo ago
    Auto-check passed
  • macOS Desktop Control

    OpenLoaf/OpenLoaf

    Guides an agent to operate native macOS apps by surveying an app first, acting through intents, menus or keystrokes, and verifying each step, in OpenLoaf Desktop only.

    108 GitHub stars~2.4k tokensUpdated 4 mo ago
    Auto-check passed

Categories

Questions about Agent Orchestration Skill

What does Agent Orchestration Skill do?

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

When should I use Agent Orchestration Skill?

Agent Orchestration Skill fits situations like: tasks that involve Multi-agent orchestration; tasks that involve Data analysis; tasks that involve Subagents.

How do I install Agent Orchestration Skill in Claude Code?

Run `npx skills add OpenLoaf/OpenLoaf --skill agent-orchestration-skill -a claude-code`. Or copy the skill folder (apps/server/src/ai/builtin-skills/agent-orchestration in OpenLoaf/OpenLoaf) into .claude/skills/agent-orchestration-skill in your project. Claude Code loads it when a task matches its description.

How do I install Agent Orchestration Skill in Codex?

Run `npx skills add OpenLoaf/OpenLoaf --skill agent-orchestration-skill -a codex`. Or copy the skill folder (apps/server/src/ai/builtin-skills/agent-orchestration in OpenLoaf/OpenLoaf) into .agents/skills/agent-orchestration-skill in your project. Codex loads it when a task matches its description.

Can I use Agent Orchestration Skill in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add OpenLoaf/OpenLoaf --skill agent-orchestration-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agent-orchestration-skill, .gemini/skills/agent-orchestration-skill, .github/skills/agent-orchestration-skill and .opencode/skills/agent-orchestration-skill in your project.

What does Agent Orchestration Skill need to run?

SKILL.md names no scripts, command-line tools or credentials: Agent Orchestration Skill is instructions for the agent only.

Does Agent Orchestration Skill access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Agent Orchestration Skill safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Agent Orchestration Skill use?

Agent Orchestration Skill is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Agent Orchestration Skill use?

About 919 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Agent Orchestration Skill?

Skills that share tags, products or a category with Agent Orchestration Skill: Waves (RayFernando1337/rayfernando-skills, 130 stars), Paseo Advisor Second Opinion (getpaseo/paseo, 20k stars), O2 Review Loop (openobserve/openobserve, 22k stars) and Harness Agent Team Designer (revfactory/harness, 9.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agent Orchestration Skill?

OpenLoaf (a GitHub organization) maintains it in OpenLoaf/OpenLoaf, which has 108 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on May 14, 2026.

Source: OpenLoaf/OpenLoaf on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.