Agent skill

Team Coordination

by bybren-llc in bybren-llc/safe-agentic-workflow

Agent Teams orchestration patterns for multi-agent SAFe workflows.

MITAuto-check: notesTesting & QA

Install Team Coordination

skills CLI
$ npx skills add bybren-llc/safe-agentic-workflow --skill team-coordination -a claude-code

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

GitHub CLI
$ gh skill install bybren-llc/safe-agentic-workflow team-coordination --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/bybren-llc/safe-agentic-workflow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/team-coordination .claude/skills/team-coordination && 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-coordination
GitHub stars
423
Token cost
~1.9k tokens
SKILL.md length
438 words
Files
2
Skills in repo
42
Repo updated
First seen
Licence
MIT

At a glance

Agent Teams orchestration patterns for multi-agent SAFe workflows.

  • Spawning agent teams
  • SKILL.md covers Purpose, Prerequisites, When This Skill Applies and Agent Teams vs Subagents vs…, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Coordinating teammates

What it does

Team Coordination is an agent skill from bybren-llc/safe-agentic-workflow. Agent Teams orchestration patterns for multi-agent SAFe workflows. Use when spawning agent teams, coordinating teammates, enforcing quality gates via task dependencies, or orchestrating the 11-agent SAFe pipeline. Covers TeamCreate, SendMessage, shared TaskList, and SAFe gate enforcement.

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `README.md`).

It sits in Testing & QA, covering Quality gates, Multi-agent orchestration and Subagents. The repository describes itself as: SAW — SAFe Agentic Workflow AI Agent Harness for Multi-Agent Team Workflows Built on SAFe methodology (Scaled Agile Framework), adapted for AI agent teams (Now With AI-DLC!)… The licence is MIT.

When your agent uses it

  • Spawning agent teams
  • Coordinating teammates
  • Enforcing quality gates via task dependencies
  • Orchestrating the 11-agent SAFe pipeline

Example prompts

  • “/team-coordination”

Requirements

  • Pre-approved tools (allowed-tools): Read, Bash, Grep, Glob, Task

What it can do on your machine

Read from SKILL.md and the folder at commit 26ca58b. 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
    • Bash
    • Grep
    • Glob
    • Task

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    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):

    • code.claude.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.

Context cost

Team Coordination loads about 1.9k tokens when it runs. Until then it costs about 77 tokens; SKILL.md has 438 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Bash, Grep, Glob, Task

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 bybren-llc/safe-agentic-workflow at commit 26ca58b, republished under its MIT licence (© bybren-llc). 438 words, ~1,861 tokens.

Download SKILL.mdSave it as .claude/skills/team-coordination/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
team-coordination
description
Agent Teams orchestration patterns for multi-agent SAFe workflows. Use when spawning agent teams, coordinating teammates, enforcing quality gates via task dependencies, or orchestrating the 11-agent SAFe pipeline. Covers TeamCreate, SendMessage, shared TaskList, and SAFe gate enforcement.
allowed-tools
Read, Bash, Grep, Glob, Task
disable-model-invocation
true
argument-hint
[task-description]

Team Coordination Skill

Purpose

Orchestrate Claude Code Agent Teams for SAFe multi-agent workflows. This skill provides patterns for spawning teams, assigning work by role, enforcing quality gates via task dependencies, and managing the full delivery pipeline.

Prerequisites

Agent Teams are experimental and must be enabled:

json
// .claude/settings.json or settings.local.json
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

When This Skill Applies

Invoke this skill when:

  • Orchestrating work across multiple agent roles (FE, BE, QAS, etc.)
  • Spawning a team for a Feature or Epic-level deliverable
  • Coordinating parallel implementation with quality gate enforcement
  • Running competing hypothesis debugging with multiple agents
  • Performing parallel code review across security, performance, and test coverage

Agent Teams vs Subagents vs Background Agents

ApproachCommunicationCoordinationBest For
Agent TeamsDMs, broadcastsShared TaskList with dependenciesComplex multi-role SAFe workflows
SubagentsReport back onlyMain agent managesFocused tasks, results only
Background AgentsNoneNoneFire-and-forget parallel work

Use Agent Teams when: teammates need to share findings, challenge each other, and coordinate via SAFe gates. Use Subagents when: you need quick, focused workers that report back. Use Background Agents when: tasks are independent and don't need coordination.

SAFe Team Patterns

Pattern 1: TDM as Team Lead

The TDM (Technical Delivery Manager) is the natural team lead in the 11-agent model:

Create an agent team for {{TICKET_PREFIX}}-XXX implementation.

Team lead (TDM) responsibilities:
- Spawn teammates by role (BE, FE, QAS, etc.)
- Create tasks with SAFe gate dependencies
- Monitor progress and steer teammates
- Synthesize results and escalate blockers

Spawn these teammates:
- BE Developer: Implement API endpoints per spec
- FE Developer: Implement UI components per spec
- QAS: Validate acceptance criteria after implementation
Pattern 2: Task Dependencies for Quality Gates

Use addBlockedBy / addBlocks to enforce the SAFe pipeline:

Task structure for {{TICKET_PREFIX}}-XXX:

1. "Implement API endpoint" (owner: be-developer)
2. "Implement UI components" (owner: fe-developer)
3. "QAS validation" (owner: qas, blockedBy: [1, 2])
4. "Create PR" (owner: rte, blockedBy: [3])
5. "Stage 1 review" (owner: system-architect, blockedBy: [4])

This enforces: Implementation → QAS → RTE → Architect Review
Pattern 3: Spawning Teammates by Role

Map harness agent roles to teammate configurations:

Spawn teammates with role-specific prompts:

BE Developer teammate:
- Load: api-patterns, rls-patterns skills
- Task: Implement endpoints per spec at specs/{{TICKET_PREFIX}}-XXX-spec.md
- Constraint: All DB operations must use RLS context helpers

FE Developer teammate:
- Load: frontend-patterns skill
- Task: Implement UI per spec
- Constraint: Follow component patterns in patterns_library/ui/

QAS teammate:
- Load: testing-patterns skill
- Task: Execute testing strategy from spec
- Constraint: Must verify all acceptance criteria before approving
- Plan approval required (require plan approval before QAS makes changes)
Pattern 4: Parallel Code Review
Create an agent team to review PR #XXX. Spawn three reviewers:
- Security reviewer: Focus on RLS enforcement, input validation, auth checks
- Architecture reviewer: Focus on pattern compliance, separation of concerns
- Test reviewer: Focus on test coverage, edge cases, acceptance criteria

Have them each review independently, then share and challenge findings.
Pattern 5: Competing Hypothesis Debugging
Users report [issue description]. Spawn 3-4 teammates to investigate:
- Teammate 1: Investigate [hypothesis A]
- Teammate 2: Investigate [hypothesis B]
- Teammate 3: Investigate [hypothesis C]

Have them talk to each other to challenge and disprove theories.
Update findings as consensus emerges.

Communication Patterns

Direct Messages (Most Common)
Send a message to the BE developer:
"The API endpoint needs to handle pagination. Check patterns_library/api/
for the standard pagination pattern before implementing."
Broadcast (Use Sparingly -- Expensive)
Broadcast to all teammates:
"STOP: Architecture decision changed. The auth middleware now uses
{{AUTH_PROVIDER}} session tokens instead of JWT. Check the updated
spec before continuing."

Only broadcast for:

  • Critical blocking issues
  • Architecture changes affecting everyone
  • Stop-the-line announcements
Shutdown Coordination
When all tasks are complete:
1. Send shutdown_request to each teammate
2. Wait for approval from each
3. Clean up team resources via TeamDelete
Show full SKILL.md (176 more words)Show less

Quality Gate Hooks

TeammateIdle Hook

Validates teammates completed their work before going idle:

json
{
  "hooks": {
    "TeammateIdle": [{
      "command": "bash -c 'echo \"Verify all assigned tasks are completed before going idle\"'",
      "description": "Validate teammate completed assigned work"
    }]
  }
}

Exit code 2 sends feedback and keeps the teammate working.

TaskCompleted Hook

Validates task output meets criteria before allowing completion:

json
{
  "hooks": {
    "TaskCompleted": [{
      "command": "bash -c 'echo \"Verify acceptance criteria met before marking complete\"'",
      "description": "Validate task meets acceptance criteria"
    }]
  }
}

Exit code 2 prevents completion and sends feedback.

Team Sizing Guidelines

Work ScopeRecommended SizeTasks per Teammate
Single Story2-3 teammates3-4 tasks each
Feature (multi-story)3-5 teammates5-6 tasks each
Epic (parallel features)5-8 teammates5-6 tasks each

Rules of thumb:

  • Start with fewer teammates; scale up if needed
  • Each teammate should own different files (avoid conflicts)
  • 5-6 tasks per teammate keeps everyone productive
  • More than 8 teammates rarely helps (coordination overhead)

Known Limitations

  • Experimental: Enable via CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS
  • No session resumption: /resume doesn't restore in-process teammates
  • One team per session: Clean up before starting a new team
  • No nested teams: Teammates cannot spawn their own teams
  • Permissions inherit: All teammates start with lead's permission mode
  • Token cost: ~7x single session in plan mode

Authoritative References

  • Official Docs: Agent Teams
  • Hooks Reference: Hooks
  • Subagents Comparison: Subagents
  • Harness Agents: AGENTS.md
  • Team Config: .claude/team-config.json

© bybren-llc, 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 1 other file in .claude/skills/team-coordination of bybren-llc/safe-agentic-workflow.

  • SKILL.md
  • README.md

Open the folder on GitHubat commit 26ca58b

Compare with similar skills

Team Coordination 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 Coordination compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Team Coordination this skillbybren-llc/safe-agentic-workflow423—~1.9kAutomated safety check: NotesMIT
NelsonAspegio/nelson422—~11kAutomated safety check: WarnMIT
Agent Teams PlaybookKimYx0207/Kim_Service174—~2.7kAutomated safety check: PassMIT
Dev ReviewFHIR/fhir-codegen155—~5kAutomated safety check: PassMIT
Prompt Generatorcatlog22/Claude-Code-Workflow2.1k—~4.7kAutomated safety check: NotesMIT
Multi Agent Task Orchestratorsickn33/agentic-awesome-skills47k2 repos~1.5kAutomated safety check: PassMIT

Similar skills

  • Nelson

    Aspegio/nelson

    Orchestrates multi-agent task execution using a Royal Navy squadron metaphor — from mission planning through parallel work coordination to stand-down.

    422 GitHub stars~11k tokensUpdated 3 mo ago
    Agent WorkflowsAuto-check: warnings
  • Agent Teams Playbook

    KimYx0207/Kim_Service

    Cross-runtime playbook for multi-agent collaboration, agent teams, swarm orchestration, parallel task distribution, capability discovery, and quality gates on Claude Code, Codex, OpenClaw, and Cursor.

    174 GitHub stars~2.7k tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed
  • Dev Review

    FHIR/fhir-codegen

    Performs a two-track code-quality and QA review in the roles of a staff-level Engineering Lead and QA Lead, then synthesizes both critiques into a single analysis.md.

    155 GitHub stars~5k tokensUpdated 3 days ago
    Testing & QAAuto-check passed
  • Prompt Generator

    catlog22/Claude-Code-Workflow

    Generate or convert Claude Code prompt files — command orchestrators, skill files, agent role definitions, or style conversion of existing files.

    2.1k GitHub stars~4.7k tokensUpdated 3 mo ago
    Testing & QAAuto-check: notes
  • Multi Agent Task Orchestrator

    sickn33/agentic-awesome-skills

    Route tasks to specialized AI agents with anti-duplication, quality gates, and 30-minute heartbeat monitoring

    47k GitHub starsUsed in 2 repos~1.5k tokens
    Testing & QAAuto-check passed
  • Agent Team Orchestration

    aAAaqwq/AGI-Super-Team

    Orchestrate multi-agent teams with defined roles, task lifecycles, handoff protocols, and review workflows.

    105 GitHub starsUsed in 3 repos~1.4k tokens
    Testing & QAAuto-check passed

More from bybren-llc/safe-agentic-workflow

All 42 skills in this repo
  • Multi-Agent Coordination Template

    bybren-llc/safe-agentic-workflow

    Agent assignment matrix, blocker escalation, and TDM coordination patterns. Use when assigning work to specialist agents, managing blockers across agents…

    423 GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed
  • API Route Patterns

    bybren-llc/safe-agentic-workflow

    API route implementation patterns with RLS, validation, and error handling. Use when creating API routes, implementing CRUD endpoints, adding server-side…

    423 GitHub stars~1.6k tokensUpdated 2 mo ago
    Auto-check passed
  • Technical Documentation Templates

    bybren-llc/safe-agentic-workflow

    Documentation templates for ADRs, runbooks, architecture docs, and knowledge transfer documents. Use when creating Architecture Decision Records, writing…

    423 GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed
  • Deployment SOP Checklist

    bybren-llc/safe-agentic-workflow

    Deployment workflows, pre-deploy validation, smoke testing, and rollback procedures. Use when deploying to staging or production, running smoke tests…

    423 GitHub stars~950 tokensUpdated 2 mo ago
    Auto-check passed
  • Frontend Patterns Template

    bybren-llc/safe-agentic-workflow

    Frontend patterns for modern web frameworks, component libraries, auth flows, and analytics. Use when building UI components, creating pages, implementing…

    423 GitHub stars~2k tokensUpdated 2 mo ago
    Auto-check passed
  • Advanced Git Operations

    bybren-llc/safe-agentic-workflow

    Advanced git operations including rebase, bisect, cherry-pick, and conflict resolution. Use when rebasing feature branches, debugging with bisect…

    423 GitHub stars~1.6k tokensUpdated 2 mo ago
    Auto-check passed

Questions about Team Coordination

What does Team Coordination do?

Agent Teams orchestration patterns for multi-agent SAFe workflows. Team Coordination is an agent skill from bybren-llc/safe-agentic-workflow. Agent Teams orchestration patterns for multi-agent SAFe workflows.

When should I use Team Coordination?

Team Coordination fits situations like: spawning agent teams; coordinating teammates; enforcing quality gates via task dependencies; orchestrating the 11-agent SAFe pipeline.

How do I install Team Coordination in Claude Code?

Run `npx skills add bybren-llc/safe-agentic-workflow --skill team-coordination -a claude-code`. Or copy the skill folder (.claude/skills/team-coordination in bybren-llc/safe-agentic-workflow) into .claude/skills/team-coordination in your project. Claude Code loads it when a task matches its description.

How do I install Team Coordination in Codex?

Run `npx skills add bybren-llc/safe-agentic-workflow --skill team-coordination -a codex`. Or copy the skill folder (.claude/skills/team-coordination in bybren-llc/safe-agentic-workflow) into .agents/skills/team-coordination in your project. Codex loads it when a task matches its description.

Can I use Team Coordination 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 bybren-llc/safe-agentic-workflow --skill team-coordination -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-coordination, .gemini/skills/team-coordination, .github/skills/team-coordination and .opencode/skills/team-coordination in your project.

What does Team Coordination need to run?

SKILL.md names no scripts, command-line tools or credentials: Team Coordination is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Bash, Grep, Glob, Task.

Does Team Coordination access the network?

SKILL.md names 1 domain. As links in the text: code.claude.com. This is read from the text; nothing was executed.

Is Team Coordination safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Team Coordination use?

Team Coordination 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 Coordination use?

About 1.9k tokens (SKILL.md is roughly 7.4k 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 Coordination?

Skills that share tags, products or a category with Team Coordination: Nelson (Aspegio/nelson, 422 stars), Agent Teams Playbook (KimYx0207/Kim_Service, 174 stars), Dev Review (FHIR/fhir-codegen, 155 stars) and Prompt Generator (catlog22/Claude-Code-Workflow, 2.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Team Coordination?

bybren-llc (a GitHub organization) maintains it in bybren-llc/safe-agentic-workflow, which has 423 GitHub stars. The repository holds 42 skills in this directory. The repository was last updated on July 20, 2026.

Source: bybren-llc/safe-agentic-workflow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.