using-agent-relay

Name: using-agent-relay
Author: AgentWorkforce

769stars58forks

How to install using-agent-relay?

agentworkforce/relay/using-agent-relay

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

Installs into the current project.

Summary

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 selecti

Files · 1

View on GitHub

SKILL.md

1	# Using Agent Relay
2
3	Use this skill when you are already a registered Agent Relay participant, or
4	when your session can register itself with `register_agent`.
5
6	If you are deciding how to start Relay, spawn workers, or choose the right role,
7	use the hosted handoff first:
8
9	```text
10	https://agentrelay.com/skill
11	```
12
13	That page links both sides of the workflow:
14
15	- outside orchestrators and human drivers use
16	[`orchestrating-agent-relay`](https://github.com/AgentWorkforce/skills/blob/main/skills/orchestrating-agent-relay/SKILL.md)
17	- spawned or registered participants use this `using-agent-relay` skill
18
19	## Role Check
20
21	Use this skill if:
22
23	- you were spawned into a Relay team
24	- the prompt gave you a workspace key or Relay identity
25	- you can call `set_workspace_key`, `create_workspace`, or `register_agent`
26	- you need to ACK, report status, DM peers, post to channels, or check inbox
27
28	Do not use this as the outside orchestrator playbook. If you are starting the
29	local broker, spawning local workers, reading terminal output, or driving worker
30	lifecycles from outside the relay, use `orchestrating-agent-relay` instead.
31
32	## Current MCP Tool Names
33
34	The current Agent Relay MCP server registers flat tool names. Use the final
35	tool name exactly as listed here.
36
37	When a client decorates MCP tool names, the prefix comes from the configured
38	server key. Workflow prompts commonly show forms like
39	`mcp__relaycast__send_dm`; a server configured as `agent-relay` may expose
40	`mcp__agent_relay__send_dm`. In every case, the canonical tool name is the flat
41	suffix, such as `send_dm`.
42
43	Do not use older category-expanded names such as
44	`mcp__relaycast__message_dm_send`, `relaycast.message.dm.send`, or
45	`message.post`.
46
47	### Workspace and Identity
48
49	\| Tool \| Use \|
50	\| ------------------- \| ----------------------------------------------------------------- \|
51	\| `create_workspace` \| Create a workspace and store its workspace key in the MCP session \|
52	\| `set_workspace_key` \| Join an existing workspace with a shared `rk_live_...` key \|
53	\| `register_agent` \| Register this session and obtain an agent token \|
54	\| `list_agents` \| List registered agents, optionally by status \|
55
56	### Channels
57
58	\| Tool \| Use \|
59	\| ------------------- \| --------------------------------- \|
60	\| `create_channel` \| Create a channel \|
61	\| `list_channels` \| List channels \|
62	\| `join_channel` \| Join a channel \|
63	\| `leave_channel` \| Leave a channel \|
64	\| `invite_to_channel` \| Invite another agent to a channel \|
65	\| `set_channel_topic` \| Update a channel topic \|
66	\| `archive_channel` \| Archive a channel \|
67
68	### Messages
69
70	\| Tool \| Use \|
71	\| --------------------- \| -------------------------------------------------- \|
72	\| `send_dm` \| Send a direct message to one agent \|
73	\| `send_group_dm` \| Create a group DM and send the first message \|
74	\| `post_message` \| Post to a channel \|
75	\| `list_messages` \| Read channel history \|
76	\| `reply_to_thread` \| Reply to an existing message \|
77	\| `get_message_thread` \| Read a thread \|
78	\| `search_messages` \| Search workspace messages \|
79	\| `check_inbox` \| Read unread messages, mentions, DMs, and reactions \|
80	\| `mark_message_read` \| Mark a message as read \|
81	\| `get_message_readers` \| List agents who read a message \|
82
83	### Reactions, Actions, and Workers
84
85	\| Tool \| Use \|
86	\| ----------------- \| ------------------------------------------------------------------------------- \|
87	\| `add_reaction` \| Add an emoji reaction to a message \|
88	\| `remove_reaction` \| Remove an emoji reaction \|
89	\| `list_actions` \| List actions available to this agent \|
90	\| `invoke_action` \| Invoke a registered Agent Relay action \|
91	\| `submit_result` \| Submit a structured task result when the spawner requested one

People who liked this also viewed

6 picks

Type

using-agent-relay

769stars58forks

View on GitHub

How to install using-agent-relay?

agentworkforce/relay/using-agent-relay

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

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Using Agent Relay
2
3	Use this skill when you are already a registered Agent Relay participant, or
4	when your session can register itself with `register_agent`.
5
6	If you are deciding how to start Relay, spawn workers, or choose the right role,
7	use the hosted handoff first:
8
9	```text
10	https://agentrelay.com/skill
11	```
12
13	That page links both sides of the workflow:
14
15	- outside orchestrators and human drivers use
16	[`orchestrating-agent-relay`](https://github.com/AgentWorkforce/skills/blob/main/skills/orchestrating-agent-relay/SKILL.md)
17	- spawned or registered participants use this `using-agent-relay` skill
18
19	## Role Check
20
21	Use this skill if:
22
23	- you were spawned into a Relay team
24	- the prompt gave you a workspace key or Relay identity
25	- you can call `set_workspace_key`, `create_workspace`, or `register_agent`
26	- you need to ACK, report status, DM peers, post to channels, or check inbox
27
28	Do not use this as the outside orchestrator playbook. If you are starting the
29	local broker, spawning local workers, reading terminal output, or driving worker
30	lifecycles from outside the relay, use `orchestrating-agent-relay` instead.
31
32	## Current MCP Tool Names
33
34	The current Agent Relay MCP server registers flat tool names. Use the final
35	tool name exactly as listed here.
36
37	When a client decorates MCP tool names, the prefix comes from the configured
38	server key. Workflow prompts commonly show forms like
39	`mcp__relaycast__send_dm`; a server configured as `agent-relay` may expose
40	`mcp__agent_relay__send_dm`. In every case, the canonical tool name is the flat
41	suffix, such as `send_dm`.
42
43	Do not use older category-expanded names such as
44	`mcp__relaycast__message_dm_send`, `relaycast.message.dm.send`, or
45	`message.post`.
46
47	### Workspace and Identity
48
49	\| Tool \| Use \|
50	\| ------------------- \| ----------------------------------------------------------------- \|
51	\| `create_workspace` \| Create a workspace and store its workspace key in the MCP session \|
52	\| `set_workspace_key` \| Join an existing workspace with a shared `rk_live_...` key \|
53	\| `register_agent` \| Register this session and obtain an agent token \|
54	\| `list_agents` \| List registered agents, optionally by status \|
55
56	### Channels
57
58	\| Tool \| Use \|
59	\| ------------------- \| --------------------------------- \|
60	\| `create_channel` \| Create a channel \|
61	\| `list_channels` \| List channels \|
62	\| `join_channel` \| Join a channel \|
63	\| `leave_channel` \| Leave a channel \|
64	\| `invite_to_channel` \| Invite another agent to a channel \|
65	\| `set_channel_topic` \| Update a channel topic \|
66	\| `archive_channel` \| Archive a channel \|
67
68	### Messages
69
70	\| Tool \| Use \|
71	\| --------------------- \| -------------------------------------------------- \|
72	\| `send_dm` \| Send a direct message to one agent \|
73	\| `send_group_dm` \| Create a group DM and send the first message \|
74	\| `post_message` \| Post to a channel \|
75	\| `list_messages` \| Read channel history \|
76	\| `reply_to_thread` \| Reply to an existing message \|
77	\| `get_message_thread` \| Read a thread \|
78	\| `search_messages` \| Search workspace messages \|
79	\| `check_inbox` \| Read unread messages, mentions, DMs, and reactions \|
80	\| `mark_message_read` \| Mark a message as read \|
81	\| `get_message_readers` \| List agents who read a message \|
82
83	### Reactions, Actions, and Workers
84
85	\| Tool \| Use \|
86	\| ----------------- \| ------------------------------------------------------------------------------- \|
87	\| `add_reaction` \| Add an emoji reaction to a message \|
88	\| `remove_reaction` \| Remove an emoji reaction \|
89	\| `list_actions` \| List actions available to this agent \|
90	\| `invoke_action` \| Invoke a registered Agent Relay action \|
91	\| `submit_result` \| Submit a structured task result when the spawner requested one

People who liked this also viewed

6 picks

Type