🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Agent Team Kit

by @ryancampbell

Framework enabling AI agent teams to self-manage work queues, clear roles, continuous discovery, and proactive operation via a heartbeat process.

Versionv1.0.0
Downloads2,763
Installs8
Stars⭐ 5
Comments2
TERMINAL
clawhub install agent-team-kit

πŸ“– About This Skill

Agent Team Kit β€” SKILL.md

*A framework for self-sustaining AI agent teams.*


What This Is

A complete team process kit for OpenClaw agents that enables:

  • Self-service work queues β€” Agents pick up tasks without human bottlenecks
  • Clear role ownership β€” Everyone knows who does what
  • Continuous discovery β€” Work flows in automatically
  • Proactive operation β€” The team runs itself via heartbeat

  • Quick Start

    1. Copy the Process Files

    # From your workspace root
    cp -r skills/agent-team-kit/templates/process ./process
    

    This creates:

  • process/INTAKE.md β€” The 5-phase work loop
  • process/ROLES.md β€” Role definitions
  • process/OPPORTUNITIES.md β€” Raw ideas/discoveries
  • process/BACKLOG.md β€” Triaged work queue
  • process/STATUS.md β€” Who's working on what
  • 2. Add Heartbeat Config

    Merge templates/HEARTBEAT.md into your existing HEARTBEAT.md:

    cat skills/agent-team-kit/templates/HEARTBEAT.md >> HEARTBEAT.md
    

    Or copy it directly if you don't have one yet.

    3. Customize Roles

    Edit process/ROLES.md to match your team:

  • Rename roles to fit your domain
  • Add/remove specialized execution roles
  • Update the human lead section with your name

  • The Intake Loop

    DISCOVER β†’ TRIAGE β†’ READY β†’ EXECUTE β†’ FEEDBACK
        ↑                                      ↓
        β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
    

    1. Discover β€” Find opportunities (Scout role) 2. Triage β€” Decide what's ready (Rhythm role) 3. Ready β€” Self-service queue (any agent) 4. Execute β€” Do the work (assigned agent) 5. Feedback β€” Learn and spawn new ideas (completing agent)


    Core Roles

    | Role | Mission | Owns | |------|---------|------| | Scout πŸ” | Find opportunities | OPPORTUNITIES.md, discovery | | Rhythm πŸ₯ | Keep work flowing | BACKLOG.md, triage | | Harmony 🀝 | Keep team healthy | Unblocking, retros | | [Human] | Strategic direction | Hard calls, spawning |

    Execution roles (spawn as needed):

  • Link πŸ”— β€” Builder
  • Pixel 🎨 β€” Designer
  • Sage πŸ¦‰ β€” Architect
  • Echo πŸ“’ β€” Voice
  • Spark ✨ β€” Creative

  • Key Principles

    Self-Service

    If it's in Ready, any agent can pick it up. No approval needed.

    Clear Ownership

    Every phase has ONE owner. No ambiguity.

    Always Log

    Ideas, discoveries, completions β€” if you don't log it, it didn't happen.

    Spawn, Don't Solo

    Main agent coordinates. Sub-agents execute. Don't do everything yourself.


    File Structure

    process/
    β”œβ”€β”€ INTAKE.md         # How the loop works (reference)
    β”œβ”€β”€ ROLES.md          # Who does what
    β”œβ”€β”€ OPPORTUNITIES.md  # Raw discoveries (anyone adds)
    β”œβ”€β”€ BACKLOG.md        # Triaged work (Rhythm maintains)
    └── STATUS.md         # Current activity (self-updated)

    HEARTBEAT.md # Proactive check triggers


    Heartbeat Integration

    Add to your heartbeat checks:

    ### Team Health (run hourly)
    
  • [ ] OPPORTUNITIES.md stale? β†’ Spawn Scout
  • [ ] Ready queue empty? β†’ Alert Rhythm
  • [ ] Active work stuck >2h? β†’ Nudge owner
  • [ ] Any unresolved blockers? β†’ Harmony
  • The heartbeat keeps the loop spinning even when the human isn't watching.


    Customization

    Adding a New Role

    1. Define in ROLES.md: - Mission (one sentence) - Owns (what they're responsible for) - Cadence (how often they work) - Outputs (what they produce)

    2. Update the ownership matrix

    3. Add spawn criteria in INTAKE.md if needed

    Changing the Loop

    The 5-phase loop is flexible. Adapt it:

  • Add validation gates between phases
  • Split EXECUTE into parallel tracks
  • Add approval checkpoints (if your domain requires it)

  • Anti-Patterns

    ❌ Human manually adds every task β†’ Use triage role instead ❌ Waiting for permission to pick up work β†’ Ready = fair game ❌ One agent does everything β†’ Spawn specialists ❌ Ideas stay in heads β†’ Log to OPPORTUNITIES.md ❌ Heartbeat just returns OK β†’ Actually check the loop


    Metrics (Optional)

    Track team health:

  • Cycle time β€” OPPORTUNITIES β†’ DONE
  • Queue depth β€” Items in Ready (healthy: 5-15)
  • Stale items β€” Days since last triage
  • Spawn rate β€” Sub-agents created per day

  • *The system runs itself. Your job is to trust it.*

    πŸ’‘ Examples

    1. Copy the Process Files

    # From your workspace root
    cp -r skills/agent-team-kit/templates/process ./process
    

    This creates:

  • process/INTAKE.md β€” The 5-phase work loop
  • process/ROLES.md β€” Role definitions
  • process/OPPORTUNITIES.md β€” Raw ideas/discoveries
  • process/BACKLOG.md β€” Triaged work queue
  • process/STATUS.md β€” Who's working on what
  • 2. Add Heartbeat Config

    Merge templates/HEARTBEAT.md into your existing HEARTBEAT.md:

    cat skills/agent-team-kit/templates/HEARTBEAT.md >> HEARTBEAT.md
    

    Or copy it directly if you don't have one yet.

    3. Customize Roles

    Edit process/ROLES.md to match your team:

  • Rename roles to fit your domain
  • Add/remove specialized execution roles
  • Update the human lead section with your name