agent-relay
Use when you need Codex to coordinate multiple agents through Agent Relay for peer-to-peer messaging, lead/worker handoffs, or shared status tracking across sub-agents and terminals.
npx skills add AgentWorkforce/relay --skill codex-relay-skill --agent codex
Same command for any agent — swap --agent for claude-code, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Agent Relay Use this skill when Codex needs real-time coordination across multiple agents. It gives Codex a repeatable workflow for: - connecting to an Agent Relay workspace - spawning relay-aware workers - sending direct messages, channel updates, and thread replies - keeping lead and worker state synchronized through ACK, STATUS, BLOCKED, and DONE signals Relay fills the peer-to-peer gap in Codex sub-agent workflows. Codex can spawn and collect worker results, but Agent Relay gives those workers a shared message bus so they can talk to the lead and to each other. ## Auto-setup On first activation, this skill auto-configures Codex by running `scripts/setup.sh`. This adds the Agent Relay MCP server to `.codex/config.toml`, enables hooks, installs `hooks.json`, and copies the `relay-worker.toml` agent definition. No manual setup is required after installing the skill. ## Startup protocol Every relay-connected Codex agent must complete these steps IN ORDER before substantive work: 1. **Set up a workspace.** - If `RELAY_WORKSPACE_KEY` is set in the environment, call `set_workspace_key` with that key. - If only the legacy `RELAY_API_KEY` alias is set, treat it as the same workspace k
- Auto-setup
- Startup protocol
- Critical rule
- Working rules
- Message templates
- Worker patterns
- Registered workspace identities
- Relay-spawned workers
- Codex sub-agents
- Worker ACK fallback
- Handoff template
What does the agent-relay skill do?
Use when you need Codex to coordinate multiple agents through Agent Relay for peer-to-peer messaging, lead/worker handoffs, or shared status tracking across sub-agents and terminals.
How do I install it?
Run `npx skills add AgentWorkforce/relay --skill codex-relay-skill --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From AgentWorkforce/relay, a repository with 784 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.