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.