Agent skill

Agent Orchestration

by yonatangross in yonatangross/orchestkit

Agent orchestration patterns for agentic loops, multi-agent coordination, alternative frameworks, and multi-scenario workflows.

MITAuto-check passedAgent Workflows

Install Agent Orchestration

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

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

GitHub CLI
$ gh skill install yonatangross/orchestkit agent-orchestration --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/yonatangross/orchestkit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/src/skills/agent-orchestration .claude/skills/agent-orchestration && 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
GitHub stars
290
Token cost
~2.8k tokens
SKILL.md length
1,001 words
Files
17 (incl. scripts, references)
Skills in repo
108
Repo updated
First seen
Licence
MIT

At a glance

Agent orchestration patterns for agentic loops, multi-agent coordination, alternative frameworks, and multi-scenario workflows.

  • Building autonomous agent loops
  • SKILL.md covers Quick Reference, Quick Start, Agent Loops and Multi-Agent Coordination, plus 8 more sections
  • Runs Python and TypeScript scripts from its folder; calls claude
  • Coordinating multiple agents

What it does

Agent Orchestration is an agent skill from yonatangross/orchestkit. Agent orchestration patterns for agentic loops, multi-agent coordination, alternative frameworks, and multi-scenario workflows. Use when building autonomous agent loops, coordinating multiple agents, evaluating CrewAI/AutoGen/Swarm, or orchestrating complex multi-step scenarios.

Its SKILL.md is about 2.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 20 other files, including scripts and reference files (for example `checklists/framework-selection.md`, `metadata.json` and `references/claude-code-instance-management.md`). Compatibility notes: Claude Code 2.1.277+.

It sits in Agent Workflows, covering Multi-agent orchestration, Building AI agents and Autonomous loops. It works with CrewAI. The repository describes itself as: The Complete AI Development Toolkit for Claude Code. 106 skills, 36 agents, 171 hooks. Install ork for stable (v9.x), or ork-alpha for the v10 line, which ships daily. The licence is MIT.

When your agent uses it

  • Building autonomous agent loops
  • Coordinating multiple agents
  • Evaluating CrewAI/AutoGen/Swarm
  • Orchestrating complex multi-step scenarios

Example prompts

  • “/agent-orchestration”

Requirements

  • Python 3
  • Node.js
  • Compatibility (from SKILL.md): Claude Code 2.1.277+.
  • Pre-approved tools (allowed-tools): Read, Glob, Grep, WebFetch, WebSearch

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Glob
    • Grep
    • WebFetch
    • WebSearch

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Python and TypeScript), which the agent can run.

    Shell commands in SKILL.md call:

    • claude

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

  • Network

    Links to these hosts (documentation or services it may open):

    • platform.openai.com
    • docs.python.org
    • anthropic.com
    • docs.crewai.com
    • openai.github.io
    • learn.microsoft.com

    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.

  • Compatibility

    Claude Code 2.1.277+.

    From compatibility in the SKILL.md frontmatter.

Context cost

Agent Orchestration loads about 2.8k tokens when it runs, and up to ~14k if it reads all its reference files. Until then it costs about 75 tokens; SKILL.md has 1,001 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~75
When it runs · the whole SKILL.md, loaded when a task matches
~2.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~14k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from yonatangross/orchestkit at commit 02bbf9a, republished under its MIT licence (© yonatangross). 1,001 words, ~2,758 tokens.

Download SKILL.mdSave it as .claude/skills/agent-orchestration/SKILL.md (or your agent's skills folder). This skill also uses 16 other files; get the full folder from GitHub.
name
agent-orchestration
description
Agent orchestration patterns for agentic loops, multi-agent coordination, alternative frameworks, and multi-scenario workflows. Use when building autonomous agent loops, coordinating multiple agents, evaluating CrewAI/AutoGen/Swarm, or orchestrating complex multi-step scenarios.
allowed-tools
Read, Glob, Grep, WebFetch, WebSearch
compatibility
Claude Code 2.1.277+.
license
MIT
user-invocable
false
disable-model-invocation
true
effort
high
metadata.owner-agent
workflow-architect
metadata.category
workflow-automation
metadata.version
2.0.0
metadata.author
OrchestKit
metadata.complexity
high
metadata.tags
agents, orchestration, multi-agent, agent-loops, crewai, autogen, swarm, coordination

Agent Orchestration

Comprehensive patterns for building and coordinating AI agents -- from single-agent reasoning loops to multi-agent systems and framework selection. Coordination and multi-scenario categories have individual rule files in rules/ loaded on-demand; loop and framework tutorials live upstream (see Upstream coverage), with house defaults in references/ork-delta.md.

CC native /workflows (2.1.154): Claude Code now ships dynamic workflows — ask Claude to create a workflow and it orchestrates tens-to-hundreds of agents in the background; view runs with /workflows. This is complementary to the patterns here: use CC /workflows for large-scale, fire-and-forget background fan-out (you check back later); use the bounded foreground Agent Teams / Task-tool patterns below when ≤8 agents must coordinate within a single skill invocation via shared memory (handoff files, mesh messaging). Different scale, not a replacement.

Ask only when genuinely blocked (CC 2.1.154): CC now reserves the multiple-choice question prompt for decisions it genuinely cannot make itself, rather than asking when it already has enough context to proceed. When orchestrating agents, don't gate progress on an AskUserQuestion the lead can resolve from available context — reserve prompts for true branch points (irreversible actions, missing requirements). This complements ork's voice-friendly decision guidance.

Quick Reference

CategoryRulesImpactWhen to Use
Agent LoopsupstreamHIGHReAct reasoning, plan-and-execute, self-correction
Multi-Agent Coordination2CRITICALSupervisor routing, agent debate, result synthesis
Alternative FrameworksupstreamHIGHCrewAI crews, AutoGen teams, framework comparison
Multi-Scenario2MEDIUMParallel scenario orchestration, difficulty routing

Total: 4 rules across 4 categories. Loop and framework tutorials moved to first-party sources; the rescued house defaults live in references/ork-delta.md.

Quick Start

python
# ReAct agent loop
async def react_loop(question: str, tools: dict, max_steps: int = 10) -> str:
    history = REACT_PROMPT.format(tools=list(tools.keys()), question=question)
    for step in range(max_steps):
        response = await llm.chat([{"role": "user", "content": history}])
        if "Final Answer:" in response.content:
            return response.content.split("Final Answer:")[-1].strip()
        if "Action:" in response.content:
            action = parse_action(response.content)
            result = await tools[action.name](*action.args)
            history += f"\nObservation: {result}\n"
    return "Max steps reached without answer"
python
# Supervisor with fan-out/fan-in
async def multi_agent_analysis(content: str) -> dict:
    agents = [("security", security_agent), ("perf", perf_agent)]
    tasks = [agent(content) for _, agent in agents]
    results = await asyncio.gather(*tasks, return_exceptions=True)
    return await synthesize_findings(results)

Agent Loops

Patterns for autonomous LLM reasoning: ReAct (Reasoning + Acting), Plan-and-Execute with replanning, self-correction loops, and sliding-window memory management.

Key decisions: Max steps 5-15, temperature 0.3-0.7, memory window 10-20 messages.

Multi-Agent Coordination

Fan-out/fan-in parallelism, supervisor routing with dependency ordering, conflict resolution (confidence-based or LLM arbitration), result synthesis, and CC Agent Teams (mesh topology for peer messaging in CC 2.1.33+).

Key decisions: 3-8 specialists, parallelize independent agents. Pick one of three modes: the Agent tool (star) for simple work, Agent Teams (mesh) for cross-cutting concerns, and a Workflow for large background fan-out you check back on later.

Alternative Frameworks

CrewAI hierarchical crews with Flows (1.8+), OpenAI Agents SDK handoffs and guardrails (0.12+), Microsoft Agent Framework (AutoGen + SK merger), GPT-5.2-Codex for long-horizon coding, and AG2 for open-source flexibility.

Key decisions: Match framework to team expertise + use case. LangGraph for state machines, CrewAI for role-based teams, OpenAI SDK for handoff workflows, MS Agent for enterprise compliance.

Multi-Scenario

Orchestrate a single skill across 3 parallel scenarios (simple/medium/complex) with progressive difficulty scaling (1x/3x/8x), milestone synchronization, and cross-scenario result aggregation.

Key decisions: Free-running with checkpoints, always 3 scenarios, 1x/3x/8x exponential scaling, 30s/90s/300s time budgets.

Upstream coverage (do not restate)

Local tutorials for these topics were retired; consult the first-party source and keep only house deltas in references/ork-delta.md.

TopicFirst-party source
ReAct / plan-and-execute / self-correction loop implementationsOpenAI function calling guide (https://platform.openai.com/docs/guides/function-calling); LangGraph tutorials (context7: /langchain-ai/langgraph)
Fan-out coordination, result-synthesis boilerplate, and the generic multi-agent design checklistPython asyncio docs (https://docs.python.org/3/library/asyncio-task.html); Anthropic "Building effective agents" (https://www.anthropic.com/research/building-effective-agents); ork:langgraph supervisor patterns
CrewAI (crews, Flows, MCP tools, guardrails)CrewAI docs (https://docs.crewai.com); context7: /crewaiinc/crewai
OpenAI Agents SDK (handoffs, sessions, guardrails, MCP)https://openai.github.io/openai-agents-python/ ; context7: /openai/openai-agents-python
Microsoft Agent Framework / AutoGen (teams, termination, A2A)https://learn.microsoft.com/en-us/agent-framework/ ; context7: /microsoft/autogen
GPT-5.2-Codex capabilities, pricing, IDE integrationsOpenAI model docs (https://platform.openai.com/docs/models)
Multi-scenario state machine, architecture and skill-agnostic template deep-divesSuperseded in-skill by rules/scenario-orchestrator.md and rules/scenario-routing.md

References

  • references/ork-delta.md - House defaults and dated decisions rescued from retired tutorials
  • references/framework-comparison.md - Condensed framework decision matrix and use-case table
  • references/langgraph-implementation.md - LangGraph 1.2+ implementation of the multi-scenario orchestrator
  • references/claude-code-instance-management.md - Running 3 parallel Claude Code instances for scenario demos
Show full SKILL.md (404 more words)Show less

Key Decisions

DecisionRecommendation
Single vs multi-agentSingle for focused tasks, multi for decomposable work
Max loop steps5-15 (prevent infinite loops)
Agent count3-8 specialists per workflow
FrameworkMatch to team expertise + use case
TopologyAgent tool (star) for simple; Agent Teams (mesh) for complex; Workflow for large background fan-out
Scenario countAlways 3: simple, medium, complex

Common Mistakes

  • No step limit in agent loops (infinite loops)
  • No memory management (context overflow)
  • No error isolation in multi-agent (one failure crashes all)
    • Note (CC 2.1.161): parallel tool calls now fail independently — a failed Bash no longer cancels siblings in the same batch. This caveat still applies at the agent-orchestration level, not to tool batches; claude agents rows now show done/total for fanned-out work.
    • Note (CC 2.1.157): claude agents honors the agent field in settings.json for dispatched sessions; --agent <name> overrides it — pin the agent type explicitly when dispatching.
  • Missing synthesis step (raw agent outputs not useful)
  • Mixing frameworks in one project (complexity explosion)
  • Using Agent Teams for simple sequential work (use the Agent tool)
  • Sequential instead of parallel scenarios (defeats purpose)
  • ork:langgraph - LangGraph workflow patterns (supervisor, routing, state)
  • function-calling - Tool definitions and execution
  • ork:task-dependency-patterns - Task management with Agent Teams workflow

Capability Details

react-loop

Keywords: react, reason, act, observe, loop, agent Solves:

  • Implement ReAct pattern
  • Create reasoning loops
  • Build iterative agents
plan-execute

Keywords: plan, execute, replan, multi-step, autonomous Solves:

  • Create plan then execute steps
  • Implement replanning on failure
  • Build goal-oriented agents
supervisor-coordination

Keywords: supervisor, route, coordinate, fan-out, fan-in, parallel Solves:

  • Route tasks to specialized agents
  • Run agents in parallel
  • Aggregate multi-agent results
agent-debate

Keywords: debate, conflict, resolution, arbitration, consensus Solves:

  • Resolve agent disagreements
  • Implement LLM arbitration
  • Handle conflicting outputs
result-synthesis

Keywords: synthesize, combine, aggregate, merge, summary Solves:

  • Combine outputs from multiple agents
  • Create executive summaries
  • Score confidence across findings
crewai-patterns

Keywords: crewai, crew, hierarchical, delegation, role-based, flows Solves:

  • Build role-based agent teams
  • Implement hierarchical coordination
  • Use Flows for event-driven orchestration
autogen-patterns

Keywords: autogen, microsoft, agent framework, teams, enterprise, a2a Solves:

  • Build enterprise agent systems
  • Use AutoGen/SK merged framework
  • Implement A2A protocol
framework-selection

Keywords: choose, compare, framework, decision, which, crewai, autogen, openai Solves:

  • Select appropriate framework
  • Compare framework capabilities
  • Match framework to requirements
scenario-orchestrator

Keywords: scenario, parallel, fan-out, difficulty, progressive, demo Solves:

  • Run skill across multiple difficulty levels
  • Implement parallel scenario execution
  • Aggregate cross-scenario results
scenario-routing

Keywords: route, synchronize, milestone, checkpoint, scaling Solves:

  • Route tasks by difficulty level
  • Synchronize at milestones
  • Scale inputs progressively

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

Files

SKILL.md and 16 other files (scripts, references) in src/skills/agent-orchestration of yonatangross/orchestkit.

  • SKILL.md
  • checklists/framework-selection.md
  • metadata.json
  • references/claude-code-instance-management.md
  • references/framework-comparison.md
  • references/langgraph-implementation.md
  • references/ork-delta.md
  • rules/_sections.md
  • rules/_template.md
  • rules/multi-debate.md
  • rules/multi-supervisor.md
  • rules/scenario-orchestrator.md
  • rules/scenario-routing.md
  • scripts/agent-workflow-template.ts
  • scripts/crewai-crew.py
  • scripts/openai-multi-agent.py
  • test-cases.json

Open the folder on GitHubat commit 02bbf9a

Compare with similar skills

Agent Orchestration 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agent Orchestration this skillyonatangross/orchestkit290—~2.8kAutomated safety check: PassMIT
AI Agent Developmentaiskillstore/marketplace4303 repos~1kAutomated safety check: PassNone
AI Agents Architectomer-metin/skills-for-antigravity162—~558Automated safety check: PassApache-2.0
Swarms Multi-Agent Frameworkkyegomez/swarms7.2k—~5.5kAutomated safety check: PassApache-2.0
Agentsop Agent Topology Selectionagentsope/SkillAlchemy466—~4.7kAutomated safety check: PassMIT
Crewai Multi AgentOrchestra-Research/AI-Research-SKILLs13k2 repos~3.4kAutomated safety check: PassMIT

Similar skills

  • AI Agent Development

    aiskillstore/marketplace

    AI agent development workflow for building autonomous agents, multi-agent systems, and agent orchestration with CrewAI, LangGraph, and custom agents.

    430 GitHub starsUsed in 3 repos~1k tokens
    Agent WorkflowsAuto-check passed
  • AI Agents Architect

    omer-metin/skills-for-antigravity

    Expert in designing and building autonomous AI agents. An agent skill from omer-metin/skills-for-antigravity.

    162 GitHub stars~558 tokensUpdated 8 mo ago
    AI & LLM EngineeringAuto-check passed
  • Teaches the Swarms Python framework: the Agent class, tools, loops, memory and multi-agent structures such as sequential, concurrent and graph workflows.

    7.2k GitHub stars~5.5k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Agentsop Agent Topology Selection

    agentsope/SkillAlchemy

    Cross-framework enhancement overlay for choosing a multi-agent topology BEFORE writing any agent.

    466 GitHub stars~4.7k tokensUpdated yesterday
    EducationAuto-check passed
  • Crewai Multi Agent

    Orchestra-Research/AI-Research-SKILLs

    Multi-agent orchestration framework for autonomous AI collaboration.

    13k GitHub starsUsed in 2 repos~3.4k tokens
    AI & LLM EngineeringAuto-check passed
  • Zeroshot

    the-open-engine/zeroshot

    Use Zeroshot to prepare, run, observe, or troubleshoot explicit multi-agent software work locally or on Zeroshot Cloud.

    1.9k GitHub stars~2k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from yonatangross/orchestkit

All 108 skills in this repo
  • API Design

    yonatangross/orchestkit

    API contract design for REST and GraphQL, covering resource shape, URL and header versioning with deprecation windows, RFC 9457 Problem Details error handling, and OpenAPI specs.

    290 GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Architecture Decision Record

    yonatangross/orchestkit

    ADR templates in the Nygard format with context, decision, consequences, and alternatives.

    290 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Audit Full

    yonatangross/orchestkit

    Single-pass codebase analysis leveraging a 1M-token context window for comprehensive security scanning, architecture review, and dependency auditing.

    290 GitHub stars~3.5k tokensUpdated today
    Auto-check: notes
  • Code Review Playbook

    yonatangross/orchestkit

    Structured review processes, conventional comments, language-specific checklists, and feedback templates.

    290 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Create PR

    yonatangross/orchestkit

    Creates GitHub pull requests with pre-flight validation, conventional title formatting, and structured summary generation.

    290 GitHub stars~4.5k tokensUpdated today
    Auto-check: notes
  • Explore

    yonatangross/orchestkit

    Multi-angle codebase exploration spawning 3-5 parallel agents for code structure, data flow, architecture patterns, and health assessment.

    290 GitHub stars~3.9k tokensUpdated today
    Auto-check: notes

Works with

Categories

Questions about Agent Orchestration

What does Agent Orchestration do?

Agent orchestration patterns for agentic loops, multi-agent coordination, alternative frameworks, and multi-scenario workflows. Agent Orchestration is an agent skill from yonatangross/orchestkit. Agent orchestration patterns for agentic loops, multi-agent coordination, alternative frameworks, and multi-scenario workflows.

When should I use Agent Orchestration?

Agent Orchestration fits situations like: building autonomous agent loops; coordinating multiple agents; evaluating CrewAI/AutoGen/Swarm; orchestrating complex multi-step scenarios.

How do I install Agent Orchestration in Claude Code?

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

How do I install Agent Orchestration in Codex?

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

Can I use Agent Orchestration 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 yonatangross/orchestkit --skill agent-orchestration -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, .gemini/skills/agent-orchestration, .github/skills/agent-orchestration and .opencode/skills/agent-orchestration in your project.

What does Agent Orchestration need to run?

Going by SKILL.md and its folder, Agent Orchestration needs Python and TypeScript for the scripts in its folder and the command-line tools its instructions call (claude). Our summary lists: Python 3; Node.js. Its frontmatter pre-approves these tools: Read, Glob, Grep, WebFetch, WebSearch. Compatibility (from SKILL.md): Claude Code 2.1.277+..

Does Agent Orchestration access the network?

SKILL.md names 6 domains. As links in the text: platform.openai.com, docs.python.org, anthropic.com, docs.crewai.com, openai.github.io and learn.microsoft.com. This is read from the text; nothing was executed.

Is Agent Orchestration 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Agent Orchestration use?

Agent Orchestration is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Agent Orchestration use?

About 2.8k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 11k tokens, read only when the agent opens those files.

What are the alternatives to Agent Orchestration?

Skills that share tags, products or a category with Agent Orchestration: AI Agent Development (aiskillstore/marketplace, 430 stars), AI Agents Architect (omer-metin/skills-for-antigravity, 162 stars), Swarms Multi-Agent Framework (kyegomez/swarms, 7.2k stars) and Agentsop Agent Topology Selection (agentsope/SkillAlchemy, 466 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agent Orchestration?

yonatangross (a GitHub user) maintains it in yonatangross/orchestkit, which has 290 GitHub stars. The repository holds 108 skills in this directory. The repository was last updated on October 9, 2026.

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