agent/agents/integrations/opencode/README.md
Snider d30a4c0d38 feat: add 153 agent personas from agency-agents
15 categories: design, engineering, game-development, marketing,
paid-media, product, project-management, sales, spatial-computing,
specialized, strategy, support, testing, examples, integrations.

Each agent has frontmatter (name, description, color, emoji, vibe)
and a detailed system prompt. Source: msitarzewski/agency-agents (MIT).

These feed into our content pipeline: agent personas drive strategy
and content generation through MixPost Enterprise, Bio.Host, and
the wider Host UK toolkit via MCP.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-12 12:34:27 +00:00

62 lines
1.4 KiB
Markdown

# OpenCode Integration
OpenCode agents are `.md` files with YAML frontmatter stored in
`.opencode/agents/`. The converter maps named colors to hex codes and adds
`mode: subagent` so agents are invoked on-demand via `@agent-name` rather
than cluttering the primary agent picker.
## Install
```bash
# Run from your project root
cd /your/project
/path/to/agency-agents/scripts/install.sh --tool opencode
```
This creates `.opencode/agents/<slug>.md` files in your project directory.
## Activate an Agent
In OpenCode, invoke a subagent with the `@` prefix:
```
@frontend-developer help build this component.
```
```
@reality-checker review this PR.
```
You can also select agents from the OpenCode UI's agent picker.
## Agent Format
Each generated agent file contains:
```yaml
---
name: Frontend Developer
description: Expert frontend developer specializing in modern web technologies...
mode: subagent
color: "#00FFFF"
---
```
- **mode: subagent** — agent is available on-demand, not shown in the primary Tab-cycle list
- **color** — hex code (named colors from source files are converted automatically)
## Project vs Global
Agents in `.opencode/agents/` are **project-scoped**. To make them available
globally across all projects, copy them to your OpenCode config directory:
```bash
mkdir -p ~/.config/opencode/agents
cp integrations/opencode/agents/*.md ~/.config/opencode/agents/
```
## Regenerate
```bash
./scripts/convert.sh --tool opencode
```