Agent skill

Team Orchestrator

by sangrokjung in sangrokjung/claude-forge

A skill your agent uses when orchestrating Agent Teams for parallel development - team composition, task distribution, dependency management, and result aggregation.

MITAuto-check passedAgent Workflows

Install Team Orchestrator

skills CLI
$ npx skills add sangrokjung/claude-forge --skill team-orchestrator -a claude-code

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

GitHub CLI
$ gh skill install sangrokjung/claude-forge team-orchestrator --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/sangrokjung/claude-forge.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/team-orchestrator .claude/skills/team-orchestrator && 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
team-orchestrator
GitHub stars
852
Token cost
~1.2k tokens
SKILL.md length
389 words
Files
1
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when orchestrating Agent Teams for parallel development - team composition, task distribution, dependency management, and result aggregation.

  • Works in 5 steps: 분석 단계 → 팀 구성 단계 → Task 생성 단계 → …
  • Orchestrating Agent Teams for parallel development - team composition
  • SKILL.md covers Overview, 전제조건, Team Composition and Task Distribution, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Team Orchestrator is an agent skill from sangrokjung/claude-forge. Use when orchestrating Agent Teams for parallel development - team composition, task distribution, dependency management, and result aggregation. Triggers on /orchestrate, multi-agent coordination, parallel team work, task delegation to teammates.

Its SKILL.md is about 1.2k 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 Dependency management, Subagents and Multi-agent orchestration. The repository describes itself as: oh-my-zsh for Claude Code — 16 agents, 35 commands, 32 skills, 21 safety hooks in one install. v4.0 adds an adversarial review loop: a second agent that never sees the first… The licence is MIT.

When your agent uses it

  • Orchestrating Agent Teams for parallel development - team composition
  • Task distribution
  • Dependency management
  • Result aggregation

Example prompts

  • “/team-orchestrator”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. 분석 단계
  2. 팀 구성 단계
  3. Task 생성 단계
  4. 실행 단계
  5. 결과 집계 단계

What it can do on your machine

Read from SKILL.md and the folder at commit 34d881d. 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

Team Orchestrator loads about 1.2k tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 389 words of instructions outside code blocks.

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

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 sangrokjung/claude-forge at commit 34d881d, republished under its MIT licence (© sangrokjung). 389 words, ~1,230 tokens.

Download SKILL.mdSave it as .claude/skills/team-orchestrator/SKILL.md (or your agent's skills folder).
name
team-orchestrator
description
Use when orchestrating Agent Teams for parallel development - team composition, task distribution, dependency management, and result aggregation. Triggers on /orchestrate, multi-agent coordination, parallel team work, task delegation to teammates.
version
1.1.0

Overview

team-orchestrator 스킬은 /orchestrate 커맨드의 핵심 엔진으로, Agent Teams를 구성하고 작업을 분배하며 결과를 집계하는 오케스트레이션 로직을 정의한다.

전제조건

Agent Teams 전제조건(환경변수 설정)은 reference/agents-teams-ref.md 참조.


Team Composition

팀 크기 결정

최대 팀원 수: Lead 1 + Teammates 3 (총 4명)

작업 규모팀원 수구성
소 (파일 1-3개)1-2명구현1 (+테스트1)
중 (파일 4-8개)2-3명구현1-2 + 테스트1
대 (파일 9개 이상)3명구현2 + 테스트1 또는 패턴별 분리
역할 템플릿

풀스택 기능 구현:

역할subagent_type담당
Frontend Devgeneral-purposeUI 구현, 컴포넌트
Backend Devgeneral-purposeAPI, DB, 로직
QA Engineergeneral-purpose테스트, E2E

리팩토링:

역할subagent_type담당
AnalyzerExplore코드 분석/계획
Implementergeneral-purpose리팩토링 실행
Verifiergeneral-purpose테스트/검증

버그 조사:

역할subagent_type담당
Investigator 1Explore코드 분석
Investigator 2Explore로그/환경 분석
Fixergeneral-purpose수정 구현

Task Distribution

파일 소유권 분리 (CRITICAL)

같은 파일을 2명이 편집하면 덮어쓰기가 발생한다. 반드시 팀원별로 파일 소유권을 분리한다.

파일 소유권 결정 로직:
  1. 변경 예상 파일 목록 생성
  2. 파일별 모듈/도메인 분류
  3. 도메인 단위로 팀원 배정
  4. 공유 파일(types, config)은 한 팀원에게 독점 배정
작업 분해 규칙

팀원당 5-6개 Task를 배정한다.

Task 크기판단 기준설명
너무 작음조율 오버헤드 > 이점하나로 합치기
적절함명확한 결과물이 있는 자체 포함 단위함수, 테스트 파일, 검토
너무 큼체크인 없이 오래 작동더 작게 분할
의존성 관리
의존성 그래프 생성:
  Task A (types 정의) → Task B (API 구현) → Task C (UI 연동)

  선행 Task가 완료되어야 후행 Task 시작 가능
  순환 의존성 감지 시 경고

TaskCreate에서 addBlockedBy 필드로 의존성을 설정한다.


Context Inheritance (CRITICAL)

팀원은 프로젝트 컨텍스트(CLAUDE.md, MCP servers, skills)를 자동 로드하지만, 리더의 대화 기록은 상속하지 않는다.

따라서 팀원 생성 프롬프트에 반드시 다음을 포함해야 한다:

  • 작업 목적과 배경
  • 관련 파일 경로
  • 기대하는 결과물
  • 주의사항/제약사항
# 좋은 예시
"Review the authentication module at src/auth/ for security vulnerabilities.
Focus on token handling, session management, and input validation.
The app uses JWT tokens stored in httpOnly cookies."

# 나쁜 예시
"보안 검토 해줘"  ← 팀원은 리더가 논의한 맥락을 모름

CLAUDE.md는 정상 작동: 팀원들은 작업 디렉토리에서 CLAUDE.md를 자동으로 읽는다.


Show full SKILL.md (160 more words)Show less

Plan Approval Mode

위험하거나 복잡한 작업에서 팀원이 구현 전 계획 승인을 받도록 할 수 있다:

Spawn an architect teammate to refactor the auth module.
Require plan approval before they make any changes.

동작:

  1. 팀원이 읽기 전용 계획 모드에서 시작
  2. 계획 완료 시 리더에게 plan_approval_request 발송
  3. 리더가 승인 → 팀원이 구현 시작
  4. 리더가 거부 (피드백 포함) → 팀원이 계획 수정 후 재제출

리더의 판단 기준을 프롬프트에 제공 가능:

  • "테스트 커버리지를 포함하는 계획만 승인"
  • "DB 스키마를 수정하는 계획 거부"

Execution Flow

1. 분석 단계
1. prompt_plan.md / spec.md 읽기
2. 변경 필요 파일 목록 생성
3. 파일별 도메인 분류
4. 작업 복잡도 추정
2. 팀 구성 단계
1. 작업 규모에 따른 팀원 수 결정
2. 역할 템플릿 선택
3. 각 팀원에게 subagent_type 배정
4. 파일 소유권 분리
3. Task 생성 단계
1. TaskCreate로 Task 목록 생성
2. 팀원별 5-6개 Task 배정
3. 의존성 설정 (addBlockedBy)
4. TaskUpdate로 owner 배정
4. 실행 단계
1. 팀원 spawn (SendMessage)
2. 각 팀원이 자신의 Task 수행
3. 리더는 조율만 수행 (직접 구현 금지)
4. 팀원 완료 시 SendMessage로 보고
4-1. 자체 청구 (Self-Claim)

작업을 마친 팀원은 다음 미할당, 차단되지 않은 작업을 자체적으로 선택한다. 작업 청구는 파일 잠금을 사용하여 경합 조건(race condition)을 방지한다.

5. 결과 집계 단계
1. 모든 팀원의 Task 완료 확인
2. 파일 충돌 여부 검증
3. 통합 빌드/테스트 실행
4. 결과 요약 생성

Result Aggregation

성공 판단 기준
전체 성공 조건:
  1. 모든 Task가 completed 상태
  2. 빌드 성공
  3. 타입 체크 통과
  4. 테스트 통과
부분 실패 처리
부분 실패 시:
  1. 실패한 Task 식별
  2. 실패 원인 분석 (의존성 문제, 파일 충돌 등)
  3. 재배정 또는 리더가 직접 해결
  4. 재시도 (최대 2회)
집계 출력 형식
════════════════════════════════════════════════════════════════
  Team Orchestration Result (v6)
════════════════════════════════════════════════════════════════

  팀원: [N]명
  총 Task: [N]개
  완료: [N]개 | 실패: [N]개

  팀원별 결과:
    [역할 1]: [완료 Task 수]/[배정 Task 수] - [상태]
    [역할 2]: [완료 Task 수]/[배정 Task 수] - [상태]
    [역할 3]: [완료 Task 수]/[배정 Task 수] - [상태]

  빌드: [PASS/FAIL]
  타입: [PASS/FAIL]
  테스트: [PASS/FAIL]

  다음 단계:
    /handoff-verify → /sync-docs → /commit-push-pr --merge --notify
    (sync-docs는 머지 전 의무 — commit-push-pr v7이 게이트 내장)

════════════════════════════════════════════════════════════════

Error Recovery

팀원 무응답
1. SendMessage로 상태 확인 (1회)
2. 5분 초과 시 Task 재배정
3. 필요시 새 팀원 생성
파일 충돌 감지
1. 리더가 git status로 충돌 감지
2. 한 팀원에게 해당 파일 소유권 위임
3. 다른 팀원은 대기 후 진행
Task 의존성 데드락
1. 순환 의존성 감지
2. 의존성 체인에서 가장 독립적인 Task 우선 실행
3. 리더가 수동으로 의존성 해소

Integration

/orchestrate 연동

/orchestrate 커맨드가 이 스킬을 호출하여:

  1. prompt_plan.md 기반 작업 분해
  2. 팀 구성 및 Task 배정
  3. 실행 및 결과 집계
/handoff-verify 연동

팀 작업 완료 후 /handoff-verify로 통합 검증을 수행한다.

© sangrokjung, MIT. 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 skills/team-orchestrator of sangrokjung/claude-forge.

Open the folder on GitHubat commit 34d881d

Compare with similar skills

Team Orchestrator 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.

Team Orchestrator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Team Orchestrator this skillsangrokjung/claude-forge852—~1.2kAutomated safety check: PassMIT
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
Sub-Agent Delegationcodewhale-hq/Codewhale41k—~790Automated safety check: PassMIT

Similar skills

  • 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 yesterday
    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 13 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
  • Sets up and drives Ruflo, an npm-installed orchestration layer for multi-agent swarms, persistent memory, routing, hooks and its MCP tool catalog.

    74k GitHub starsUsed in 1 repo~975 tokens
    Agent WorkflowsAuto-check passed

More from sangrokjung/claude-forge

All 24 skills in this repo
  • Debugging Strategies

    sangrokjung/claude-forge

    Master systematic debugging techniques, profiling tools, and root cause analysis to efficiently track down bugs across any codebase or technology stack.

    852 GitHub starsUsed in 13 repos~3.1k tokens
    Auto-check passed
  • Dependency Upgrade

    sangrokjung/claude-forge

    Manage major dependency version upgrades with compatibility analysis, staged rollout, and comprehensive testing.

    852 GitHub starsUsed in 12 repos~2.3k tokens
    Auto-check passed
  • Skill Factory

    sangrokjung/claude-forge

    Analyze session work and automatically convert reusable patterns into Claude Code skills.

    852 GitHub stars~2.7k tokensUpdated 1 mo ago
    Auto-check passed
  • Cc Dev Agent

    sangrokjung/claude-forge

    A skill your agent uses when starting Claude Code projects, writing CLAUDE.md/spec.md, dispatching subagents, or requesting Agent Teams parallel development.

    852 GitHub stars~771 tokensUpdated 1 mo ago
    Auto-check passed
  • Continuous Learning V2

    sangrokjung/claude-forge

    Instinct-based learning system that observes sessions via hooks, creates atomic instincts with confidence scoring, and evolves them into skills/commands/agents.

    852 GitHub starsUsed in 5 repos~1.8k tokens
    Auto-check passed
  • Harness Diet

    sangrokjung/claude-forge

    Measure and shrink the always-loaded context of a Claude Code harness (CLAUDE.md + rules without paths frontmatter) back under budget — migrate narrative to reference files, convert rules to…

    852 GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Team Orchestrator

What does Team Orchestrator do?

A skill your agent uses when orchestrating Agent Teams for parallel development - team composition, task distribution, dependency management, and result aggregation. Team Orchestrator is an agent skill from sangrokjung/claude-forge. Use when orchestrating Agent Teams for parallel development - team composition, task distribution, dependency management, and result aggregation.

When should I use Team Orchestrator?

Team Orchestrator fits situations like: orchestrating Agent Teams for parallel development - team composition; task distribution; dependency management; result aggregation.

How do I install Team Orchestrator in Claude Code?

Run `npx skills add sangrokjung/claude-forge --skill team-orchestrator -a claude-code`. Or copy the skill folder (skills/team-orchestrator in sangrokjung/claude-forge) into .claude/skills/team-orchestrator in your project. Claude Code loads it when a task matches its description.

How do I install Team Orchestrator in Codex?

Run `npx skills add sangrokjung/claude-forge --skill team-orchestrator -a codex`. Or copy the skill folder (skills/team-orchestrator in sangrokjung/claude-forge) into .agents/skills/team-orchestrator in your project. Codex loads it when a task matches its description.

Can I use Team Orchestrator 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 sangrokjung/claude-forge --skill team-orchestrator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/team-orchestrator, .gemini/skills/team-orchestrator, .github/skills/team-orchestrator and .opencode/skills/team-orchestrator in your project.

What does Team Orchestrator need to run?

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

Does Team Orchestrator 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 Team Orchestrator 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 Team Orchestrator use?

Team Orchestrator is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Team Orchestrator use?

About 1.2k tokens (SKILL.md is roughly 4.9k 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 Team Orchestrator?

Skills that share tags, products or a category with Team Orchestrator: Paseo Advisor Second Opinion (getpaseo/paseo, 20k stars), O2 Review Loop (openobserve/openobserve, 22k stars), Harness Agent Team Designer (revfactory/harness, 9.1k stars) and ClawTeam Multi-Agent Swarm (win4r/ClawTeam-OpenClaw, 1.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Team Orchestrator?

sangrokjung (a GitHub user) maintains it in sangrokjung/claude-forge, which has 852 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on September 3, 2026.

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