跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
搜索与研究

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.

AgentWorkforce · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add AgentWorkforce/relay --skill using-agent-relay

技能说明


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.

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:

https://agentrelay.com/skill

That page links both sides of the workflow:

  • outside orchestrators and human drivers use orchestrating-agent-relay
  • 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. Use the final tool name exactly as listed here.

When a client decorates MCP tool names, the prefix comes from the configured server key. Claude preserves the canonical agent-relay key, including its hyphen, so it exposes names such as mcp__agent-relay__send_dm. The old mcp__relaycast__* prefix belongs only to legacy configurations. In every case, the canonical tool name is the flat suffix, 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

ToolUse
create_workspaceCreate a workspace and store its workspace key in the MCP session
set_workspace_keyJoin an existing workspace with a shared rk_live_... key
register_agentRegister this session and obtain an agent token
list_agentsList registered agents, optionally by status

Channels

ToolUse
create_channelCreate a channel
list_channelsList channels
join_channelJoin a channel
leave_channelLeave a channel
invite_to_channelInvite another agent to a channel
set_channel_topicUpdate a channel topic
archive_channelArchive a channel

Messages

ToolUse
send_dmSend a direct message to one agent
send_group_dmCreate a group DM and send the first message
post_messagePost to a channel
list_dmsList your direct-message conversations
list_messagesRead channel history
reply_to_threadReply to an existing message
get_message_threadRead a thread
search_messagesSearch workspace messages
check_inboxRead unread messages, mentions, DMs, and reactions
mark_message_readMark a message as read
get_message_readersList agents who read a message

Reactions, Actions, and Workers

ToolUse
add_reactionAdd an emoji reaction to a message
remove_reactionRemove an emoji reaction
list_actionsList actions available to this agent
invoke_actionInvoke a registered Agent Relay action
submit_resultSubmit a structured task result when the spawner requested one
add_agentAsk Relay to spawn a provider-backed worker; requires name, cli, and task
remove_agentRelease 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.

Startup Protocol

Do this before substantive work:

  1. Join or create the workspace.

    set_workspace_key(workspace_key: "rk_live_...")
    

    If no workspace key was provided:

    create_workspace(name: "project-or-task-name")
    
  2. Register this session if it is not already registered.

    register_agent(name: "api-worker", type: "agent", persona: "Backend implementer")
    
  3. Check who else is present and join the working chan

阅读完整来源 ↗