Bootstrap Google Tools
google/adk-recipes
Install/auth CLIs the sandbox lacks - gws (Drive, Gmail, Sheets, Calendar), gcloud, agents-cli, mcp-cli (MCP servers).
A skill your agent uses when you are a registered relay agent (a spawned worker, or a lead that called registeragent) coordinating with peers in real time over current Agent Relay MCP tools -…
Install Using Agent Relay
$ npx skills add AgentWorkforce/relay --skill using-agent-relay -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install AgentWorkforce/relay using-agent-relay --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/AgentWorkforce/relay.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/using-agent-relay .claude/skills/using-agent-relay && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "using-agent-relay" agent skill from https://github.com/AgentWorkforce/relay/tree/main/.agents/skills/using-agent-relay into .claude/skills/using-agent-relay/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "using-agent-relay", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/AgentWorkforce/relay/tree/main/.agents/skills/using-agent-relayType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add AgentWorkforce/relay --skill using-agent-relay -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install AgentWorkforce/relay using-agent-relay --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/AgentWorkforce/relay.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/using-agent-relay .agents/skills/using-agent-relay && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "using-agent-relay" agent skill from https://github.com/AgentWorkforce/relay/tree/main/.agents/skills/using-agent-relay into .agents/skills/using-agent-relay/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "using-agent-relay", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add AgentWorkforce/relay --skill using-agent-relay -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install AgentWorkforce/relay using-agent-relay --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/AgentWorkforce/relay.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/using-agent-relay .cursor/skills/using-agent-relay && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "using-agent-relay" agent skill from https://github.com/AgentWorkforce/relay/tree/main/.agents/skills/using-agent-relay into .cursor/skills/using-agent-relay/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "using-agent-relay", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/AgentWorkforce/relay.git --path .agents/skills/using-agent-relay--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add AgentWorkforce/relay --skill using-agent-relay -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install AgentWorkforce/relay using-agent-relay --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/AgentWorkforce/relay.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/using-agent-relay .gemini/skills/using-agent-relay && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "using-agent-relay" agent skill from https://github.com/AgentWorkforce/relay/tree/main/.agents/skills/using-agent-relay into .gemini/skills/using-agent-relay/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "using-agent-relay", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install AgentWorkforce/relay using-agent-relayInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add AgentWorkforce/relay --skill using-agent-relay -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/AgentWorkforce/relay.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/using-agent-relay .github/skills/using-agent-relay && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "using-agent-relay" agent skill from https://github.com/AgentWorkforce/relay/tree/main/.agents/skills/using-agent-relay into .github/skills/using-agent-relay/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "using-agent-relay", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add AgentWorkforce/relay --skill using-agent-relay -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install AgentWorkforce/relay using-agent-relay --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/AgentWorkforce/relay.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/using-agent-relay .opencode/skills/using-agent-relay && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "using-agent-relay" agent skill from https://github.com/AgentWorkforce/relay/tree/main/.agents/skills/using-agent-relay into .opencode/skills/using-agent-relay/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "using-agent-relay", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
using-agent-relay- GitHub stars
- 865
- Used in
- 1 other repo
- Token cost
- ~2k tokens
- SKILL.md length
- 524 words
- Files
- 1
- Skills in repo
- 14
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
A skill your agent uses when you are a registered relay agent (a spawned worker, or a lead that called registeragent) coordinating with peers in real time over current Agent Relay MCP tools -…
- You are a registered relay agent (a spawned worker
- Reaches agentrelay.com
- A lead that called registeragent) coordinating with peers in real time over current Agent Relay MCP tools - messaging
- Worker spawn/release
What it does
Using Agent Relay is an agent skill from AgentWorkforce/relay. Use when you are a registered relay agent (a spawned worker, or a lead that called registeragent) 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.
Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Agent Workflows, covering MCP servers and Email management. It works with Model Context Protocol. The repository describes itself as: Infrastructure for coding agents. The licence is Apache-2.0.
When your agent uses it
- You are a registered relay agent (a spawned worker
- A lead that called registeragent) coordinating with peers in real time over current Agent Relay MCP tools - messaging
- Worker spawn/release
Example prompts
- “/using-agent-relay”
What it can do on your machine
Read from SKILL.md and the folder at commit 734600d. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
agentrelay.com
Also links to:
github.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Using Agent Relay loads about 2k tokens when it runs. Until then it costs about 103 tokens; SKILL.md has 524 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from AgentWorkforce/relay at commit 734600d, republished under its Apache-2.0 licence (© AgentWorkforce). 524 words, ~2,024 tokens.
Download SKILL.mdSave it as
.claude/skills/using-agent-relay/SKILL.md (or your agent's skills folder).- name
- using-agent-relay
- description
- 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.
Role Check
- 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, orregister_agent - you need to ACK, report status, DM peers, post to channels, or check inbox
Current MCP Tool Names
The current Agent Relay MCP server registers flat tool names. Use the final tool name exactly as listed here.
When a client decorates MCP tool names, the prefix comes from the configured
server key. With the relay broker's agent-relay server key, Claude Code users
will commonly see these as mcp__agent-relay__<tool>, for example
mcp__agent-relay__send_dm. Codex and opencode users see the bare canonical
names, such as send_dm.
Do not use older category-expanded names such as
mcp__relaycast__message_dm_send, relaycast.message.dm.send, or
message.post.
Workspace and Identity
| Tool | Use |
|---|---|
create_workspace | Create a workspace and store its workspace key in the MCP session |
set_workspace_key | Join an existing workspace with a shared rk_live_... key |
register_agent | Register this session and obtain an agent token |
list_agents | List registered agents, optionally by status |
Channels
| Tool | Use |
|---|---|
create_channel | Create a channel |
list_channels | List channels |
join_channel | Join a channel |
leave_channel | Leave a channel |
invite_to_channel | Invite another agent to a channel |
set_channel_topic | Update a channel topic |
archive_channel | Archive a channel |
Messages
| Tool | Use |
|---|---|
send_dm | Send a direct message to one agent |
send_group_dm | Create a group DM and send the first message |
post_message | Post to a channel |
list_messages | Read channel history |
reply_to_thread | Reply to an existing message |
get_message_thread | Read a thread |
search_messages | Search workspace messages |
check_inbox | Read unread messages, mentions, DMs, and reactions |
mark_message_read | Mark a message as read |
get_message_readers | List agents who read a message |
Reactions, Actions, and Workers
| Tool | Use |
|---|---|
add_reaction | Add an emoji reaction to a message |
remove_reaction | Remove an emoji reaction |
list_actions | List actions available to this agent |
invoke_action | Invoke a registered Agent Relay action |
submit_result | Submit a structured task result when the spawner requested one |
add_agent | Ask Relay to spawn a provider-backed worker; requires name, cli, and task |
remove_agent | Release or optionally delete a worker |
submit_result is only present for spawned tasks that configured result
collection. list_actions and invoke_action are present when actions are
enabled.
Show full SKILL.md (176 more words)Show less
Startup Protocol
Do this before substantive work:
set_workspace_key(workspace_key: "rk_live_...")Communication Protocol
Use concise status messages:
send_dm(to: "Lead", text: "STATUS: Auth routes are implemented; running tests next.")
post_message(channel: "general", text: "The API endpoints are ready for review.")
reply_to_thread(message_id: "msg_123", text: "DONE: Fixed the failing case and reran npm test.")
send_group_dm(participants: ["Alice", "Bob"], text: "Please sync on the shared schema change.")Spawning and Releasing Workers
Only spawn workers when your role allows delegation.
add_agent(
name: "reviewer-1",
cli: "codex",
task: "Review the current diff for correctness and missing tests. ACK first, then report DONE with findings."
)Current CLI Reference
These are the current CLI forms for local broker and SDK-backed messaging
agent-relay status
agent-relay local up --no-dashboard --verbose
agent-relay local status --wait-for 10
agent-relay local agent list
agent-relay local agent spawn claude --name Worker --task "Use https://agentrelay.com/skill and ACK over Relay."
agent-relay local tail --agent Worker
agent-relay local agent attach Worker --mode view
agent-relay local 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_...
agent-relay message post general "Status update" --workspace-key rk_live_... --token at_live_...
agent-relay message list general --workspace-key rk_live_... --token at_live_...
agent-relay message reply msg_123 "Thread reply" --workspace-key rk_live_... --token at_live_...Overview
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:
https://agentrelay.com/skillThat page links both sides of the workflow:
- outside orchestrators and human drivers use
orchestrating-agent-relay - spawned or registered participants use this
using-agent-relayskill
Common Mistakes
| Mistake | Fix |
|---|---|
Using message_dm_send or message.post | Use current flat tools: send_dm, post_message, reply_to_thread |
| Acting as orchestrator with participant tools | Use orchestrating-agent-relay, or register yourself first |
| Calling tools before selecting a workspace | Call set_workspace_key or create_workspace first |
Spawning with add_agent(name, type) | add_agent needs name, cli, and task; use register_agent for identity |
| Forgetting to ACK | Send ACK: to the lead before starting work |
| Finishing silently | Send DONE: with evidence before stopping |
© AgentWorkforce, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .agents/skills/using-agent-relay of AgentWorkforce/relay.
Open the folder on GitHubat commit 734600d
Used in 1 other repository
We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in AgentWorkforce/relay, which our catalogue first saw on October 7, 2026.
Compare with similar skills
Using Agent Relay next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Using Agent Relay this skillAgentWorkforce/relay | 865 | 1 repos | ~2k | Automated safety check: Pass | Apache-2.0 | |
| Bootstrap Google Toolsgoogle/adk-recipes | 10k | — | ~5k | Automated safety check: Warn | Apache-2.0 | |
| ObservalObserval/Observal | 4.1k | — | ~2.2k | Automated safety check: Pass | Apache-2.0 | |
| E2a Setuptokencanopy/e2a | 192 | — | ~820 | Automated safety check: Pass | Apache-2.0 | |
| Performance Patternss-morgan-jeffries/apple-mail-fast-mcp | 104 | — | ~1.5k | Automated safety check: Pass | MIT | |
| Unbrowseunbrowse-ai/unbrowse | 776 | — | ~3.3k | Automated safety check: Pass | MIT |
Similar skills
- Official
Observal
Observal/Observal
A skill your agent uses when starting any task the organization may already have an approved skill, prompt, MCP server, or Agent for: reviewing code, a commit, a diff, or a pull request; writing…
E2a Setup
tokencanopy/e2a
A skill your agent uses when a user wants to connect or authorize the e2a MCP server, select or create an agent inbox, verify first-run readiness, or set up a custom email domain.
Performance Patterns
s-morgan-jeffries/apple-mail-fast-mcp
A skill your agent uses when optimizing Apple Mail MCP operations, diagnosing slow queries, adding new filtering logic, or modifying how data is fetched from Mail.app.
Unbrowse
unbrowse-ai/unbrowse
Search and call websites through Unbrowse's hosted API or remote MCP, reuse indexed site tools, read pages, and learn missing routes in its cloud browser.
Gemini Skill
WJZ-P/gemini-skill
通过 Gemini 官网（gemini.google.com）执行生图、对话等操作。用户提到"生图/画图/绘图/nano banana/nanobanana/生成图片"等关键词时触发。操作方式分三级优先级：首选 MCP 工具 → 次选 Skill 脚本 → 最次连接 Skill 浏览器手动操作（需用户授权）。禁止自行启动外部浏览器访问 Gemini。
More from AgentWorkforce/relay
All 14 skills in this repoBrowser Testing With Screenshots
AgentWorkforce/relay
A skill your agent uses when testing web applications with visual verification - automates Chrome browser interactions, element selection, and screenshot capture for confirming UI functionality
Agent Relay
AgentWorkforce/relay
A skill your agent uses 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…
Debugging Websocket Issues
AgentWorkforce/relay
A skill your agent uses when seeing WebSocket errors like "Invalid frame header", "RSV1 must be clear", or "WSERRUNEXPECTEDRSV1" - covers multiple WebSocketServer conflicts, compression issues, and…
GitHub OAuth Nango Integration
AgentWorkforce/relay
A skill your agent uses when implementing GitHub OAuth + GitHub App authentication with Nango - provides two-connection pattern for user login and repo access with webhook handling
Implementing Command Palettes
AgentWorkforce/relay
A skill your agent uses when building Cmd+K command palettes in React - covers keyboard navigation with arrow keys, keeping selected items in view with scrollIntoView, filtering with shortcut…
Deploying To Staging Environment
AgentWorkforce/relay
A skill your agent uses when deploying changes to staging across relay, relay-dashboard, and relay-cloud repos - coordinates multi-repo branch syncing using git worktrees, automatically triggers…
Related
Works with
Categories
Questions about Using Agent Relay
What does Using Agent Relay do?
A skill your agent uses when you are a registered relay agent (a spawned worker, or a lead that called registeragent) coordinating with peers in real time over current Agent Relay MCP tools -…. Using Agent Relay is an agent skill from AgentWorkforce/relay. Use when you are a registered relay agent (a spawned worker, or a lead that called registeragent) coordinating with peers in real time over current Agent Relay MCP tools - messaging, channels, threads, reactions, search, inbox, actions, and worker spawn/release.
When should I use Using Agent Relay?
Using Agent Relay fits situations like: you are a registered relay agent (a spawned worker; A lead that called registeragent) coordinating with peers in real time over current Agent Relay MCP tools - messaging; worker spawn/release.
How do I install Using Agent Relay in Claude Code?
Run `npx skills add AgentWorkforce/relay --skill using-agent-relay -a claude-code`. Or copy the skill folder (.agents/skills/using-agent-relay in AgentWorkforce/relay) into .claude/skills/using-agent-relay in your project. Claude Code loads it when a task matches its description.
How do I install Using Agent Relay in Codex?
Run `npx skills add AgentWorkforce/relay --skill using-agent-relay -a codex`. Or copy the skill folder (.agents/skills/using-agent-relay in AgentWorkforce/relay) into .agents/skills/using-agent-relay in your project. Codex loads it when a task matches its description.
Can I use Using Agent Relay in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AgentWorkforce/relay --skill using-agent-relay -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/using-agent-relay, .gemini/skills/using-agent-relay, .github/skills/using-agent-relay and .opencode/skills/using-agent-relay in your project.
What does Using Agent Relay need to run?
SKILL.md names no scripts, command-line tools or credentials: Using Agent Relay is instructions for the agent only.
Does Using Agent Relay access the network?
SKILL.md names 2 domains. In commands or code: agentrelay.com; the agent is likely to contact it when it follows the instructions. As links in the text: github.com. This is read from the text; nothing was executed.
Is Using Agent Relay safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Using Agent Relay use?
Using Agent Relay is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Using Agent Relay use?
About 2k tokens (SKILL.md is roughly 8.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Using Agent Relay?
Skills that share tags, products or a category with Using Agent Relay: Bootstrap Google Tools (google/adk-recipes, 10k stars), Observal (Observal/Observal, 4.1k stars), E2a Setup (tokencanopy/e2a, 192 stars) and Performance Patterns (s-morgan-jeffries/apple-mail-fast-mcp, 104 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Using Agent Relay?
AgentWorkforce (a GitHub organization) maintains it in AgentWorkforce/relay, which has 865 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 7, 2026.
Source: AgentWorkforce/relay on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.