using-agent-relay
Use when you are a registered relay agent (a spawned worker, or a lead that called register_agent) coordinating with peers in real time over current Agent Relay MCP tools - messaging, channels, threads, reactions, search, inbox, actions, and worker spawn/release. For role selection and orchestrator startup instructions, use https://agentrelay.com/skill and the orchestrating-agent-relay skill.
npx skills add AgentWorkforce/relay --skill using-agent-relay --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Using Agent Relay Use this skill when you are already a registered Agent Relay participant, or when your session can register itself with `register_agent`. If you are deciding how to start Relay, spawn workers, or choose the right role, use the hosted handoff first: ```text https://agentrelay.com/skill ``` That page links both sides of the workflow: - outside orchestrators and human drivers use [`orchestrating-agent-relay`](https://github.com/AgentWorkforce/skills/blob/main/skills/orchestrating-agent-relay/SKILL.md) - spawned or registered participants use this `using-agent-relay` skill ## Role Check Use this skill if: - you were spawned into a Relay team - the prompt gave you a workspace key or Relay identity - you can call `set_workspace_key`, `create_workspace`, or `register_agent` - you need to ACK, report status, DM peers, post to channels, or check inbox Do not use this as the outside orchestrator playbook. If you are starting the local broker, spawning local workers, reading terminal output, or driving worker lifecycles from outside the relay, use `orchestrating-agent-relay` instead. ## Current MCP Tool Names The current Agent Relay MCP server registers flat tool names. Us
- Role Check
- Current MCP Tool Names
- Workspace and Identity
- Channels
- Messages
- Reactions, Actions, and Workers
- Startup Protocol
- Communication Protocol
- Spawning and Releasing Workers
- Current CLI Reference
- Common Mistakes
agent-relay status agent-relay node agent list agent-relay node agent spawn claude --name Worker --task "Use https://agentrelay.com/skill and ACK over Relay." agent-relay node tail --agent Worker agent-relay node agent attach Worker --mode view agent-relay node agent release Worker agent-relay agent register Worker --workspace-key rk_live_... agent-relay agent list --workspace-key rk_live_... agent-relay message inbox check --workspace-key rk_live_... --token at_live_... agent-relay message dm send Lead "ACK: I am online." --workspace-key rk_live_... --token at_live_...
What does the using-agent-relay skill do?
Use when you are a registered relay agent (a spawned worker, or a lead that called register_agent) coordinating with peers in real time over current Agent Relay MCP tools - messaging, channels, threads, reactions, search, inbox, actions, and worker spawn/release. For role selection and orchestrator startup instructions, use https://agentrelay.com/skill and the orchestrating-agent-relay skill.
How do I install it?
Run `npx skills add AgentWorkforce/relay --skill using-agent-relay --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.