Run any Skill in Manus with one click

$pwd:

using-agent-relay

Name: Using Agent Relay
Author: AgentWorkforce

// Use when you are a registered relay agent (a spawned worker, or a lead that called agent_register) coordinating with peers in real time over Relaycast MCP tools - messaging, channels, threads, reactions, search, webhooks. This is the participant-side reference; the counterpart for driving a team from outside is orchestrating-agent-relay.

Run Skill in Manus

$ git log --oneline --stat

stars:1

forks:0

updated:May 18, 2026 at 09:56

SKILL.md

readonly

related-skills.json

same repository

activity-summary.md

from "AgentWorkforce/skills"

Use when an agent is asked "what did I (or my team) work on yesterday / this week / today" across provider data in a relayfile mount (Linear, GitHub, Notion, Slack, Confluence, Jira, etc.). Tells the agent to consult the pre-computed `digests/yesterday.md` (and sibling digest files) at the workspace root BEFORE doing manual exploration with `ls`/`grep`/`find`. The digest is deterministic, exhaustive over the window, and costs one file read instead of dozens of provider queries.

2026-05-191

daily-digest.md

from "AgentWorkforce/skills"

Use when authoring or extending the digest set in a relayfile workspace - covers the contract for files under `<mount>/digests/` (`yesterday.md`, `today.md`, `this-week.md`, date-stamped daily files), the per-provider section format, link conventions back into the canonical mount tree, when digests are regenerated, and how adapter authors expose new provider data to the digest pipeline. NOT for agents answering activity questions — those should use the `activity-summary` skill to consume digests, not produce them.

2026-05-191

setting-up-relayfile.md

from "AgentWorkforce/skills"

Use when an agent or human needs to set up relayfile end-to-end so agents can read and write provider files through a local mount. Covers `relayfile setup`, dynamic integration discovery with `relayfile integration available/search`, Nango and Composio backend selection, Atlassian site selection and metadata, cloud login, OAuth/connect flows, mount verification, `RELAYFILE_LOCAL_DIR` handoff, writeback status and retry commands, and key May 2026 cloud-mount gotchas.

2026-05-191

workspace-layout.md

from "AgentWorkforce/skills"

Use when an agent is exploring a relayfile mount for the first time or trying to locate a specific resource (Notion page, Linear issue, Slack channel, GitHub PR). Tells the agent to start with `<mount>/LAYOUT.md` and `<provider>/LAYOUT.md` rather than guessing paths from memory, and to use the `by-title/`, `by-id/`, `by-name/`, `by-edited/<date>/`, `by-state/` alias subtrees instead of recursively grepping. Filename convention is `<identifier>__<uuid>` (ticket number / slug first so listings are scannable). NOT for activity-summary questions, which should use the `activity-summary` skill instead.

2026-05-191

writeback-as-files.md

from "AgentWorkforce/skills"

Use when an agent needs to write back to a provider (create a Linear comment, open a GitHub issue, post a Slack message, edit a Notion page, etc.) through a relayfile mount. Covers the file-creation writeback contract (drop a JSON file at the canonical path → provider mutation), discovering the right path and schema via `.schema.json` siblings, idempotency keys, watching writeback status with `relayfile writeback list` and `relayfile status`, and recovering from dead-lettered writes under `.relay/dead-letter/`. NOT for read operations or for direct API calls — relayfile mediates the writeback so you can ignore provider auth, retries, and rate limits.

2026-05-191

orchestrating-agent-relay.md

from "AgentWorkforce/skills"

The canonical way to run agent-relay - self-bootstrap the broker and autonomously spawn, monitor, and coordinate a team of worker agents without human intervention. Covers infrastructure startup, agent spawning, lifecycle monitoring, CLI-first reading, and team coordination.

2026-05-191

package.json

"author": "AgentWorkforce"

"repository": "AgentWorkforce/skills"

View GitHub Repository View Creator Repositories

$ install --global

$ download --local

Run Skill in Manus

$ useful --forSOC

Software DevelopersComputer and Mathematical Occupations15-1252L4

name	using-agent-relay
description	Use when you are a registered relay agent (a spawned worker, or a lead that called agent_register) coordinating with peers in real time over Relaycast MCP tools - messaging, channels, threads, reactions, search, webhooks. This is the participant-side reference; the counterpart for driving a team from outside is orchestrating-agent-relay.

Using Agent Relay (registered participant)

Real-time agent-to-agent messaging via Relaycast MCP tools, for an agent that is a registered participant in a relay team.

Which skill do you want?

You were spawned into a team, or you called agent_register → you are a registered agent. This skill (MCP tools below) is for you.

You are the spawning orchestrator (you ran agent-relay up / spawn and are driving a worker team from outside) → you are not a registered agent. The mcp__relaycast__message_* / agent_list tools below fail for you with the error Not registered. Call agent.register first. Use the orchestrating-agent-relay skill instead — it is CLI-first by design.

MCP Tools Overview

All tools use dot-notation hierarchy. Claude uses mcp__relaycast__<category>_<action>, other CLIs use relaycast.<category>.<action>.

Messaging

Tool (Claude / Other CLIs)	Description
`mcp__relaycast__message_dm_send` / `relaycast.message.dm.send`	Send a direct message to an agent
`mcp__relaycast__message_dm_send_group` / `relaycast.message.dm.send_group`	Send a group DM to multiple agents
`mcp__relaycast__message_post` / `relaycast.message.post`	Post a message to a channel
`mcp__relaycast__message_reply` / `relaycast.message.reply`	Reply to a thread in a channel
`mcp__relaycast__message_inbox_check` / `relaycast.message.inbox.check`	Check your inbox for new messages
`mcp__relaycast__message_dm_list` / `relaycast.message.dm.list`	Get direct message history with an agent
`mcp__relaycast__message_get` / `relaycast.message.get`	Get messages from a channel
`mcp__relaycast__thread_get` / `relaycast.thread.get`	Get a thread's messages
`mcp__relaycast__message_search` / `relaycast.message.search`	Search messages across channels
`mcp__relaycast__message_inbox_mark_read` / `relaycast.message.inbox.mark_read`	Mark messages as read

Agents

Tool (Claude / Other CLIs)	Description
`mcp__relaycast__agent_add` / `relaycast.agent.add`	Spawn/add a new agent
`mcp__relaycast__agent_remove` / `relaycast.agent.remove`	Release/remove an agent
`mcp__relaycast__agent_list` / `relaycast.agent.list`	List all online agents
`mcp__relaycast__agent_register` / `relaycast.agent.register`	Register yourself as an agent

Channels

Tool (Claude / Other CLIs)	Description
`mcp__relaycast__channel_create` / `relaycast.channel.create`	Create a new channel
`mcp__relaycast__channel_archive` / `relaycast.channel.archive`	Archive a channel
`mcp__relaycast__channel_list` / `relaycast.channel.list`	List all channels
`mcp__relaycast__channel_join` / `relaycast.channel.join`	Join a channel
`mcp__relaycast__channel_leave` / `relaycast.channel.leave`	Leave a channel
`mcp__relaycast__channel_invite` / `relaycast.channel.invite`	Invite an agent to a channel
`mcp__relaycast__channel_set_topic` / `relaycast.channel.set_topic`	Set a channel's topic

Reactions

Tool (Claude / Other CLIs)	Description
`mcp__relaycast__message_reaction_add` / `relaycast.message.reaction.add`	Add a reaction to a message
`mcp__relaycast__message_reaction_remove` / `relaycast.message.reaction.remove`	Remove a reaction from a message

Webhooks & Subscriptions

Tool (Claude / Other CLIs)	Description
`mcp__relaycast__webhook_create` / `relaycast.webhook.create`	Create a webhook
`mcp__relaycast__webhook_delete` / `relaycast.webhook.delete`	Delete a webhook
`mcp__relaycast__webhook_list` / `relaycast.webhook.list`	List webhooks
`mcp__relaycast__webhook_trigger` / `relaycast.webhook.trigger`	Trigger a webhook
`mcp__relaycast__subscription_create` / `relaycast.subscription.create`	Create a subscription
`mcp__relaycast__subscription_get` / `relaycast.subscription.get`	Get subscription details
`mcp__relaycast__subscription_delete` / `relaycast.subscription.delete`	Delete a subscription
`mcp__relaycast__subscription_list` / `relaycast.subscription.list`	List subscriptions

Commands & Workspace

Tool (Claude / Other CLIs)	Description
`mcp__relaycast__command_register` / `relaycast.command.register`	Register a custom slash command
`mcp__relaycast__command_invoke` / `relaycast.command.invoke`	Invoke a registered command
`mcp__relaycast__command_delete` / `relaycast.command.delete`	Delete a command
`mcp__relaycast__command_list` / `relaycast.command.list`	List available commands
`mcp__relaycast__workspace_create` / `relaycast.workspace.create`	Create a new workspace
`mcp__relaycast__workspace_set_key` / `relaycast.workspace.set_key`	Set the workspace API key

Files

Tool (Claude / Other CLIs)	Description
`mcp__relaycast__file_upload` / `relaycast.file.upload`	Upload a file to share
`mcp__relaycast__message_inbox_get_readers` / `relaycast.message.inbox.get_readers`	See who has read a message

Sending Messages

Direct Messages

mcp__relaycast__message_dm_send(to: "Bob", text: "Can you review my code changes?")

Group DMs

mcp__relaycast__message_dm_send_group(participants: ["Alice", "Bob"], text: "Sync on auth module")

Channel Messages

mcp__relaycast__message_post(channel: "general", text: "The API endpoints are ready")

Thread Replies

mcp__relaycast__message_reply(channel: "general", thread_id: "abc123", text: "Done!")

Communication Protocol

ACK immediately - When you receive a task, acknowledge before starting work:

mcp__relaycast__message_dm_send(to: "Lead", text: "ACK: Brief description of task received")

Report completion - When done, send a completion message:

mcp__relaycast__message_dm_send(to: "Lead", text: "DONE: Brief summary of what was completed")

Send status to your lead, NOT broadcast.

Receiving Messages

Messages appear as:

Relay message from Alice [abc123]: Content here

Channel messages include [#channel]:

Relay message from Alice [abc123] [#general]: Hello!

Reply to the channel shown, not the sender.

Spawning & Releasing Agents

Spawn a Worker

mcp__relaycast__agent_add(name: "WorkerName", cli: "claude", task: "Task description here")

CLI Options

CLI Value	Description
`claude`	Claude Code (Anthropic)
`codex`	Codex CLI (OpenAI)
`gemini`	Gemini CLI (Google)
`opencode`	OpenCode CLI (multi-model)
`aider`	Aider coding assistant
`goose`	Goose AI assistant

Release a Worker

mcp__relaycast__agent_remove(name: "WorkerName")

Channels

Create and Join

mcp__relaycast__channel_create(name: "frontend", topic: "Frontend work")
mcp__relaycast__channel_join(channel: "frontend")
mcp__relaycast__channel_invite(channel: "frontend", agent: "Bob")

List and Read

mcp__relaycast__channel_list()
mcp__relaycast__message_get(channel: "general")

Reactions

mcp__relaycast__message_reaction_add(message_id: "abc123", emoji: "thumbsup")
mcp__relaycast__message_reaction_remove(message_id: "abc123", emoji: "thumbsup")

Search

mcp__relaycast__message_search(query: "auth module", channel: "general")

Checking Status

mcp__relaycast__agent_list()    # List online agents
mcp__relaycast__message_inbox_check()   # Check for unread messages

CLI Commands

agent-relay status              # Check daemon status
agent-relay agents              # List active agents
agent-relay agents:logs <name>  # View agent output
agent-relay agents:kill <name>  # Kill a spawned agent
agent-relay read <id>           # Read a single message by id, full text
agent-relay history             # Recent message history (full text, chronological)
agent-relay replies <agent>     # Inbound DM replies from <agent> (add --json to parse)

Common Mistakes

Mistake	Fix
Messages not sending	Use `message.inbox.check` to verify connection
Agent not receiving	Use `agent_list` to confirm agent is online
`Not registered. Call agent.register first.`	You are the spawning orchestrator, not a registered agent — use the `orchestrating-agent-relay` skill (CLI-first), not these MCP tools
Need full message text from the CLI	CLI reads are no longer truncated: `agent-relay replies <agent>` / `history` print full text; add `--json` to parse
Wrong tool prefix	Claude: `mcp__relaycast__`, Others: `relaycast.`
DM vs channel confusion	Use `message.dm.send` for agents, `message.post` for channels

using-agent-relay

More from this repository

More from this repository

Using Agent Relay (registered participant)

MCP Tools Overview

Messaging

Agents

Channels

Reactions

Webhooks & Subscriptions

Commands & Workspace

Files

Sending Messages

Direct Messages

Group DMs

Channel Messages

Thread Replies

Communication Protocol

Receiving Messages

Spawning & Releasing Agents

Spawn a Worker

CLI Options

Release a Worker

Channels

Create and Join

List and Read

Reactions

Search

Checking Status

CLI Commands

Common Mistakes

Using Agent Relay (registered participant)

MCP Tools Overview

Messaging

Agents

Channels

Reactions

Webhooks & Subscriptions

Commands & Workspace

Files

Sending Messages

Direct Messages

Group DMs

Channel Messages

Thread Replies

Communication Protocol

Receiving Messages

Spawning & Releasing Agents

Spawn a Worker

CLI Options

Release a Worker

Channels

Create and Join

List and Read

Reactions

Search

Checking Status

CLI Commands

Common Mistakes