inbox-write

Sends messages to another agent's inbox for agent-to-agent communication.

1.4k|292|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/yohey-w/multi-agent-shogun --skill inbox-write
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: inbox-write
Source: https://github.com/yohey-w/multi-agent-shogun/tree/main/.cursor/skills/inbox-write
Command: npx skills add https://github.com/yohey-w/multi-agent-shogun --skill inbox-write

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

In a multi-agent tmux orchestration setup, agents need a controlled way to communicate with each other. This Skill provides the single sanctioned channel for sending messages between agents (shogun, karo, ashigaru, gunshi), replacing error-prone direct tmux send-keys injection.

Core Features & Use Cases

  • Agent-to-Agent Messaging: Writes a message into a target agent's inbox via the inbox_write.sh script.
  • Typed Message Semantics: Supports message types such as cmd_new (shogun to karo), task_assigned (karo to ashigaru), report_received (ashigaru to karo/gunshi), clear_command, and model_switch.
  • Use Case: A karo (manager) agent finishes decomposing a command and notifies ashigaru3 to begin work by sending a task_assigned message referencing the task YAML.

Quick Start

Ask the agent to send a message to another agent's inbox, for example: notify karo that cmd_048 was written and should be executed.

Frequently Asked Questions about inbox-write

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send a message to another agent in a multi-agent tmux setup?▼

Run bash scripts/inbox_write.sh with the target agent name, the message text, a message type, and the sender name. This writes the message into the target agent's inbox, which is the only permitted communication path.

What message types does agent inbox communication support?▼

The supported types are cmd_new for new commands from shogun to karo, task_assigned for karo assigning work to ashigaru, report_received for completion reports, clear_command for session resets, and model_switch for model change instructions.

Can I use tmux send-keys to message another agent directly?▼

No. Direct tmux send-keys messaging is explicitly prohibited. All inter-agent messages must go through the inbox_write.sh script so they are recorded in the target agent's inbox with a proper type and sender.

How does a worker agent report task completion to a manager agent?▼

The worker sends a report_received message to the karo or gunshi inbox, for example: bash scripts/inbox_write.sh gunshi "task complete, requesting quality check" report_received ashigaru5.