README

🔌 Integrations

This directory contains The Agency integrations and converted formats for supported agentic coding tools.

Supported Tools

• Claude Code —

  .md

  agents, use the repo directly
• GitHub Copilot —

  .md

  agents, use the repo directly
• Antigravity —

  SKILL.md

  per agent in

  antigravity/

• Gemini CLI — extension +

  SKILL.md

  files in

  gemini-cli/

• OpenCode —

  .md

  agent files in

  opencode/

• OpenClaw —

  SOUL.md

  +

  AGENTS.md

  +

  IDENTITY.md

  workspaces
• Cursor —

  .mdc

  rule files in

  cursor/

• Aider —

  CONVENTIONS.md

  in

  aider/

• Windsurf —

  .windsurfrules

  in

  windsurf/

• Kimi Code — YAML agent specs in

  kimi/

Quick Install

# Install for all detected tools automatically
./scripts/install.sh

# Install a specific home-scoped tool
./scripts/install.sh --tool antigravity
./scripts/install.sh --tool copilot
./scripts/install.sh --tool openclaw
./scripts/install.sh --tool claude-code

# Gemini CLI needs generated integration files on a fresh clone
./scripts/convert.sh --tool gemini-cli
./scripts/install.sh --tool gemini-cli

For project-scoped tools such as OpenCode, Cursor, Aider, and Windsurf, run the installer from your target project root as shown in the tool-specific sections below.

Regenerating Integration Files

If you add or modify agents, regenerate all integration files:

./scripts/convert.sh

---

Claude Code

The Agency was originally designed for Claude Code. Agents work natively without conversion.

cp -r <category>/*.md ~/.claude/agents/
# or install everything at once:
./scripts/install.sh --tool claude-code

See claude-code/README.md for details.

---

GitHub Copilot

The Agency also works natively with GitHub Copilot. Agents can be copied directly into

~/.github/agents/

and

~/.copilot/agents/

without conversion.

./scripts/install.sh --tool copilot

See github-copilot/README.md for details.

---

Antigravity

Skills are installed to

~/.gemini/antigravity/skills/

. Each agent becomes a separate skill prefixed with

agency-

to avoid naming conflicts.

./scripts/install.sh --tool antigravity

See antigravity/README.md for details.

---

Gemini CLI

Agents are packaged as a Gemini CLI extension with individual skill files. The extension is installed to

~/.gemini/extensions/agency-agents/

. Because the Gemini manifest and skill folders are generated artifacts, run

./scripts/convert.sh --tool gemini-cli

before installing from a fresh clone.

./scripts/convert.sh --tool gemini-cli
./scripts/install.sh --tool gemini-cli

See gemini-cli/README.md for details.

---

OpenCode

Each agent becomes a project-scoped

.md

file in

.opencode/agents/

.

cd /your/project && /path/to/agency-agents/scripts/install.sh --tool opencode

See opencode/README.md for details.

---

OpenClaw

Each agent becomes an OpenClaw workspace containing

SOUL.md

,

AGENTS.md

, and

IDENTITY.md

.

Before installing, generate the OpenClaw workspaces:

./scripts/convert.sh --tool openclaw

Then install them:

./scripts/install.sh --tool openclaw

See openclaw/README.md for details.

---

Cursor

Each agent becomes a

.mdc

rule file. Rules are project-scoped — run the installer from your project root.

cd /your/project && /path/to/agency-agents/scripts/install.sh --tool cursor

See cursor/README.md for details.

---

Aider

All agents are consolidated into a single

CONVENTIONS.md

file that Aider reads automatically when present in your project root.

cd /your/project && /path/to/agency-agents/scripts/install.sh --tool aider

See aider/README.md for details.

---

Windsurf

All agents are consolidated into a single

.windsurfrules

file for your project root.

cd /your/project && /path/to/agency-agents/scripts/install.sh --tool windsurf

See windsurf/README.md for details.

---

Kimi Code

Each agent is converted to a Kimi Code CLI agent specification (YAML format with separate system prompt files). Agents are installed to

~/.config/kimi/agents/

.

Because the Kimi agent files are generated from the source Markdown, run

./scripts/convert.sh --tool kimi

before installing from a fresh clone.

./scripts/convert.sh --tool kimi
./scripts/install.sh --tool kimi

Usage

After installation, use an agent with the

--agent-file

flag:

kimi --agent-file ~/.config/kimi/agents/frontend-developer/agent.yaml

Or in a specific project:

cd /your/project
kimi --agent-file ~/.config/kimi/agents/frontend-developer/agent.yaml \
     --work-dir /your/project

See kimi/README.md for details.