From 927d0ee42b682bfa85aee37026078f93c755159b Mon Sep 17 00:00:00 2001 From: Yimikami Date: Wed, 11 Mar 2026 16:27:41 +0300 Subject: [PATCH 1/2] docs: align integration docs with supported tools --- .gitignore | 3 +- README.md | 12 ++++--- integrations/README.md | 47 +++++++++++++++++++++++++-- integrations/claude-code/README.md | 2 +- integrations/github-copilot/README.md | 10 +++--- integrations/openclaw/README.md | 28 ++++++++++++++++ 6 files changed, 88 insertions(+), 14 deletions(-) create mode 100644 integrations/openclaw/README.md diff --git a/.gitignore b/.gitignore index cf5e5a5..37e4512 100644 --- a/.gitignore +++ b/.gitignore @@ -73,4 +73,5 @@ integrations/opencode/agents/ integrations/cursor/rules/ integrations/aider/CONVENTIONS.md integrations/windsurf/.windsurfrules -integrations/openclaw/ +integrations/openclaw/* +!integrations/openclaw/README.md diff --git a/README.md b/README.md index 28b1650..92d91f2 100644 --- a/README.md +++ b/README.md @@ -441,7 +441,7 @@ The Agency works natively with Claude Code, and ships conversion + install scrip ### Supported Tools - **[Claude Code](https://claude.ai/code)** — native `.md` agents, no conversion needed → `~/.claude/agents/` -- **[Github Copilot](https://github.com/copilot)** — native `.md` agents, no conversion needed → `~/.github/agents/` +- **[GitHub Copilot](https://github.com/copilot)** — native `.md` agents, no conversion needed → `~/.github/agents/` - **[Antigravity](https://github.com/google-gemini/antigravity)** — `SKILL.md` per agent → `~/.gemini/antigravity/skills/` - **[Gemini CLI](https://github.com/google-gemini/gemini-cli)** — extension + `SKILL.md` files → `~/.gemini/extensions/agency-agents/` - **[OpenCode](https://opencode.ai)** — `.md` agent files → `.opencode/agents/` @@ -522,7 +522,7 @@ See [integrations/claude-code/README.md](integrations/claude-code/README.md) for
-Github Copilot +GitHub Copilot Agents are copied directly from the repo into `~/.github/agents/` -- no conversion needed. @@ -530,7 +530,7 @@ Agents are copied directly from the repo into `~/.github/agents/` -- no conversi ./scripts/install.sh --tool copilot ``` -Then activate in Github Copilot: +Then activate in GitHub Copilot: ``` Use the Frontend Developer agent to review this component. ``` @@ -558,7 +558,7 @@ See [integrations/antigravity/README.md](integrations/antigravity/README.md) for
Gemini CLI -Installs as a Gemini CLI extension with 80 skills + a manifest. +Installs as a Gemini CLI extension with one skill per agent plus a manifest. ```bash ./scripts/install.sh --tool gemini-cli @@ -656,6 +656,8 @@ Each agent becomes a workspace with `SOUL.md`, `AGENTS.md`, and `IDENTITY.md` in Agents are registered and available by `agentId` in OpenClaw sessions. +See [integrations/openclaw/README.md](integrations/openclaw/README.md) for details. +
--- @@ -675,7 +677,7 @@ When you add new agents or edit existing ones, regenerate all integration files: - [ ] Interactive agent selector web tool - [x] Multi-agent workflow examples -- see [examples/](examples/) -- [x] Multi-tool integration scripts (Claude Code, Antigravity, Gemini CLI, OpenCode, OpenClaw, Cursor, Aider, Windsurf) +- [x] Multi-tool integration scripts (Claude Code, GitHub Copilot, Antigravity, Gemini CLI, OpenCode, OpenClaw, Cursor, Aider, Windsurf) - [ ] Video tutorials on agent design - [ ] Community agent marketplace - [ ] Agent "personality quiz" for project matching diff --git a/integrations/README.md b/integrations/README.md index 5f5dfa3..3bb0868 100644 --- a/integrations/README.md +++ b/integrations/README.md @@ -1,14 +1,16 @@ # 🔌 Integrations -This directory contains The Agency's 61 AI agents converted into formats -compatible with popular agentic coding tools. +This directory contains The Agency integrations and converted formats for +supported agentic coding tools. ## Supported Tools - **[Claude Code](#claude-code)** — `.md` agents, use the repo directly +- **[GitHub Copilot](#github-copilot)** — `.md` agents, use the repo directly - **[Antigravity](#antigravity)** — `SKILL.md` per agent in `antigravity/` - **[Gemini CLI](#gemini-cli)** — extension + `SKILL.md` files in `gemini-cli/` - **[OpenCode](#opencode)** — `.md` agent files in `opencode/` +- **[OpenClaw](#openclaw)** — `SOUL.md` + `AGENTS.md` + `IDENTITY.md` workspaces - **[Cursor](#cursor)** — `.mdc` rule files in `cursor/` - **[Aider](#aider)** — `CONVENTIONS.md` in `aider/` - **[Windsurf](#windsurf)** — `.windsurfrules` in `windsurf/` @@ -22,6 +24,9 @@ compatible with popular agentic coding tools. # Install for a specific tool ./scripts/install.sh --tool antigravity ./scripts/install.sh --tool gemini-cli +./scripts/install.sh --tool copilot +./scripts/install.sh --tool opencode +./scripts/install.sh --tool openclaw ./scripts/install.sh --tool cursor ./scripts/install.sh --tool aider ./scripts/install.sh --tool windsurf @@ -53,6 +58,19 @@ See [claude-code/README.md](claude-code/README.md) for details. --- +## GitHub Copilot + +The Agency also works natively with GitHub Copilot. Agents can be copied +directly into `~/.github/agents/` without conversion. + +```bash +./scripts/install.sh --tool copilot +``` + +See [github-copilot/README.md](github-copilot/README.md) for details. + +--- + ## Antigravity Skills are installed to `~/.gemini/antigravity/skills/`. Each agent becomes @@ -79,6 +97,31 @@ See [gemini-cli/README.md](gemini-cli/README.md) for details. --- +## OpenCode + +Each agent becomes a project-scoped `.md` file in `.opencode/agents/`. + +```bash +cd /your/project && /path/to/agency-agents/scripts/install.sh --tool opencode +``` + +See [opencode/README.md](opencode/README.md) for details. + +--- + +## OpenClaw + +Each agent becomes an OpenClaw workspace containing `SOUL.md`, `AGENTS.md`, +and `IDENTITY.md`. + +```bash +./scripts/install.sh --tool openclaw +``` + +See [openclaw/README.md](openclaw/README.md) for details. + +--- + ## Cursor Each agent becomes a `.mdc` rule file. Rules are project-scoped — run the diff --git a/integrations/claude-code/README.md b/integrations/claude-code/README.md index b20d6f3..bd67f9e 100644 --- a/integrations/claude-code/README.md +++ b/integrations/claude-code/README.md @@ -28,4 +28,4 @@ Use the Reality Checker agent to verify this feature is production-ready. ## Agent Directory Agents are organized into divisions. See the [main README](../../README.md) for -the full roster of 61 specialists. +the full current roster. diff --git a/integrations/github-copilot/README.md b/integrations/github-copilot/README.md index 0d2b27b..2065549 100644 --- a/integrations/github-copilot/README.md +++ b/integrations/github-copilot/README.md @@ -1,12 +1,12 @@ -# Github Copilot Integration +# GitHub Copilot Integration -The Agency was built for Github Copilot. No conversion needed — agents work +The Agency works natively with GitHub Copilot. No conversion needed — agents work natively with the existing `.md` + YAML frontmatter format. ## Install ```bash -# Copy all agents to your Github Copilot agents directory +# Copy all agents to your GitHub Copilot agents directory ./scripts/install.sh --tool copilot # Or manually copy a category @@ -15,7 +15,7 @@ cp engineering/*.md ~/.github/agents/ ## Activate an Agent -In any Github Copilot session, reference an agent by name: +In any GitHub Copilot session, reference an agent by name: ``` Activate Frontend Developer and help me build a React component. @@ -28,4 +28,4 @@ Use the Reality Checker agent to verify this feature is production-ready. ## Agent Directory Agents are organized into divisions. See the [main README](../../README.md) for -the full roster of 61 specialists. +the full current roster. diff --git a/integrations/openclaw/README.md b/integrations/openclaw/README.md new file mode 100644 index 0000000..7d4a30d --- /dev/null +++ b/integrations/openclaw/README.md @@ -0,0 +1,28 @@ +# OpenClaw Integration + +OpenClaw agents are installed as workspaces containing `SOUL.md`, `AGENTS.md`, +and `IDENTITY.md` files. The installer copies each workspace into +`~/.openclaw/agency-agents/` and registers it when the `openclaw` CLI is +available. + +## Install + +```bash +./scripts/install.sh --tool openclaw +``` + +## Activate an Agent + +After installation, agents are available by `agentId` in OpenClaw sessions. + +If the OpenClaw gateway is already running, restart it after installation: + +```bash +openclaw gateway restart +``` + +## Regenerate + +```bash +./scripts/convert.sh --tool openclaw +``` From ca1fa75a23b67b9a3a3f9f32bdd34b51c54c1e2a Mon Sep 17 00:00:00 2001 From: Yimikami Date: Wed, 11 Mar 2026 16:48:26 +0300 Subject: [PATCH 2/2] docs: clarify scoped installs and openclaw setup --- integrations/README.md | 18 +++++++++++++----- integrations/github-copilot/README.md | 4 ++-- integrations/openclaw/README.md | 6 ++++++ 3 files changed, 21 insertions(+), 7 deletions(-) diff --git a/integrations/README.md b/integrations/README.md index 3bb0868..c51b039 100644 --- a/integrations/README.md +++ b/integrations/README.md @@ -21,18 +21,18 @@ supported agentic coding tools. # Install for all detected tools automatically ./scripts/install.sh -# Install for a specific tool +# Install a specific home-scoped tool ./scripts/install.sh --tool antigravity ./scripts/install.sh --tool gemini-cli ./scripts/install.sh --tool copilot -./scripts/install.sh --tool opencode ./scripts/install.sh --tool openclaw -./scripts/install.sh --tool cursor -./scripts/install.sh --tool aider -./scripts/install.sh --tool windsurf ./scripts/install.sh --tool claude-code ``` +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: @@ -114,6 +114,14 @@ See [opencode/README.md](opencode/README.md) for details. Each agent becomes an OpenClaw workspace containing `SOUL.md`, `AGENTS.md`, and `IDENTITY.md`. +Before installing, generate the OpenClaw workspaces: + +```bash +./scripts/convert.sh --tool openclaw +``` + +Then install them: + ```bash ./scripts/install.sh --tool openclaw ``` diff --git a/integrations/github-copilot/README.md b/integrations/github-copilot/README.md index 2065549..8c094b4 100644 --- a/integrations/github-copilot/README.md +++ b/integrations/github-copilot/README.md @@ -1,7 +1,7 @@ # GitHub Copilot Integration -The Agency works natively with GitHub Copilot. No conversion needed — agents work -natively with the existing `.md` + YAML frontmatter format. +The Agency works with GitHub Copilot out of the box. No conversion needed — +agents use the existing `.md` + YAML frontmatter format. ## Install diff --git a/integrations/openclaw/README.md b/integrations/openclaw/README.md index 7d4a30d..7399e7a 100644 --- a/integrations/openclaw/README.md +++ b/integrations/openclaw/README.md @@ -5,6 +5,12 @@ and `IDENTITY.md` files. The installer copies each workspace into `~/.openclaw/agency-agents/` and registers it when the `openclaw` CLI is available. +Before installing, generate the OpenClaw workspaces: + +```bash +./scripts/convert.sh --tool openclaw +``` + ## Install ```bash