본문으로 건너뛰기
cccskills
무료GitHub에 공개

agent-squad

Create and manage teams of specialized AI agents that work together on tasks. Use when setting up multi-agent workflows, agent squads for content/marketing/research pipelines, configuring heartbeat-based agent coordination, or managing agent personalities via SOUL.md files. Enables orchestration of multiple OpenClaw sessions as a coordinated team with shared task systems (Linear, Trello, etc.).

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

연동 도구LinearTrelloGitHub
설치 방법 보기

포함된 파일(8)

  • SKILL.md6.9 KB
  • assets/blog-why-your-ai-needs-a-team.md3.6 KB
  • assets/LOKI_WORK_LOG.md1.4 KB
  • assets/twitter-thread-agent-squad-launch.md1.5 KB
  • references/agents-template.md459 B
  • references/personalities.md8.2 KB
  • references/workflows.md8.2 KB
  • scripts/agent-squad14.8 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Agent Squad

Orchestrate teams of specialized AI agents that collaborate on tasks via shared workspaces and heartbeat scheduling.

Quick Start

# Initialize your squad
agent-squad init my-squad

# Add agents
agent-squad add researcher --role "Deep researcher. Finds sources and data."
agent-squad add writer --role "Content writer. Sharp, opinionated voice."
agent-squad add lead --role "Squad lead. Coordinates and reports."

# Configure task system
agent-squad config --tasks linear --project "Content Squad"

# Start heartbeats (agents wake every 15 min)
agent-squad start

What This Enables

Before: One AI doing everything. Context bloat. Generic output.

After: Specialized agents with distinct roles, shared task board, coordinated via heartbeats. Each agent:

  • Has a unique personality (SOUL.md)
  • Checks for work every 15 minutes (cron)
  • Posts updates to shared task system
  • @mentions other agents when handoffs needed

Core Concepts

Agents = OpenClaw Sessions

Each agent is an isolated OpenClaw session with:

  • Unique session key (agent:{name}:main)
  • Custom SOUL.md (personality, role, tools)
  • Heartbeat cron (wakes periodically)
  • Access to shared task system

The Heartbeat Pattern

Instead of always-on agents (expensive), agents wake on schedule:

:00  Lead checks Linear → delegates tasks
:05  Researcher checks → does research, @mentions Writer  
:10  Writer checks → reads research, writes draft

Agents check for @mentions, assigned tasks, and activity. If nothing to do → HEARTBEAT_OK and sleep.

Shared Task Systems

Agents coordinate via task system comments:

  • Linear (recommended) — Issues, comments, states
  • Trello — Cards, lists, checklists
  • GitHub Issues — Native integration
  • Files — Markdown in git repo

Commands

Squad Management

agent-squad init <name>              # Create new squad workspace
agent-squad status                   # Show all agents and health
agent-squad logs <agent>             # View recent heartbeats

Agent Management

agent-squad add <name> [options]
  --role "Description of role"
  --personality "skeptical|creative|analytical"
  --schedule "*/15 * * * *"
  --model "kimi-code"

agent-squad edit <name>              # Edit SOUL.md
agent-squad remove <name>            # Remove agent and cron
agent-squad disable <name>           # Pause heartbeats
agent-squad enable <name>            # Resume heartbeats

Task System Integration

agent-squad config --tasks linear    # Use Linear
agent-squad config --tasks trello    # Use Trello
agent-squad config --tasks github    # Use GitHub Issues
agent-squad config --tasks file      # Use local markdown files

Operations

agent-squad start                    # Start all heartbeats
agent-squad stop                     # Stop all heartbeats
agent-squad trigger <agent>          # Manual heartbeat trigger
agent-squad notify "@writer draft ready"  # Send notification

Example: Content Marketing Squad

3 agents, Linear integration:

# Setup
agent-squad init content-squad
agent-squad add fury --role "Researcher. Every claim needs a source."
agent-squad add loki --role "Writer. Sharp, anti-fluff voice."
agent-squad add jarvis --role "Lead. Coordinates, reports to human."

agent-squad config --tasks linear --project "Content Squad"
agent-squad start

Workflow:

  1. You create Linear issue: "Blog post: AI Agent Security"
  2. Jarvis (lead) assigns to Fury (researcher)
  3. Fury heartbeat → researches → posts findings → @mentions Loki
  4. Loki heartbeat → writes draft → posts → @mentions Jarvis
  5. Jarvis notifies you via Telegram: "Draft ready for review"

SOUL.md Templates

See references/personalities.md for pre-built agent personalities:

  • Researcher (Fury)
  • Writer (Loki)
  • Lead (Jarvis)
  • SEO Analyst (Vision)
  • Social Media (Quill)
  • Developer (Friday)

Advanced

Custom Heartbeat Schedules

Stagger agents to prevent all waking at once:

agent-squad add lead --schedule "0,15,30,45 * * * *"
agent-squad add researcher --schedule "5,20,35,50 * * * *"
agent-squad add writer --schedule "10,25,40,55 * * * *"

AGENTS.md (Shared Operations Manual)

Each agent workspace includes AGENTS.md with:

  • Squad mission
  • Communication rules (@mentions, handoffs)
  • File conventions
  • Escalation procedures

See references/agents-template.md

Multi-Model Squads

Use cheaper models for heartbeats, premium for creative work:

agent-squad add researcher --model "kimi-code"        # Cheap, fast
agent-squad add writer --model "claude-opus-4-5"      # Premium creative

Architecture

┌─────────────────────────────────────────────┐
│           OpenClaw Gateway                  │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐       │
│  │  Lead   │ │Researcher│ │ Writer │       │
│  │ Session │ │ Session  │ │Session │       │
│  │ (Jarvis)│ │ (Fury)   │ │(Loki)  │       │
│  └────┬────┘ └────┬────┘ └────┬────┘       │
│       │           │           │             │
│       └───────────┼───────────┘             │
│                   │                         │
│              ┌────┴────┐                    │
│              │  Cron   │                    │
│              │ Jobs    │                    │
│              └────┬────┘                    │
└───────────────────┼─────────────────────────┘
                    │
            ┌───────┴───────┐
            │  Task System  │
            │  (Linear/etc) │
            └───────────────┘

Requirements

  • OpenClaw gateway running
  • Task system credentials (Linear API key, Trello token, etc.)
  • Node.js (for CLI)

See Also

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Use when working with the 1Password CLI (`op` command) for secrets management, retrieving API keys, injecting secrets into development environments, or any task involving 1Password vault operations. Triggers on: "1password", "op command", "secrets management", "api keys from vault", "op run", "op read", "service account token".

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

thedaviddias/agent-forge32026년 5월 18일 업데이트

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

thedaviddias/agent-forge32026년 5월 18일 업데이트

Create algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use when users request generative art, algorithmic art, flow fields, or particle systems. Create original works rather than copying existing artists.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

thedaviddias/agent-forge32026년 5월 18일 업데이트

CSS and UI animation patterns for responsive, polished interfaces. Use when implementing hover effects, tooltips, button feedback, transitions, or fixing animation issues like flicker and shakiness.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

thedaviddias/agent-forge32026년 5월 18일 업데이트

Use when starting creative work (features, components, functionality, or behavior changes) to clarify user intent, requirements, and design before implementation.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

thedaviddias/agent-forge32026년 5월 18일 업데이트

Applies Anthropic brand colors and typography to artifacts that need a consistent look-and-feel. Use when brand colors, style guidelines, visual formatting, or company design standards apply.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

thedaviddias/agent-forge32026년 5월 18일 업데이트

thedaviddias의 스킬 모두 보기

이 스킬의 문제 신고