| name | mailbox-operate |
| description | Operate the mailbox system with three commands -> mailbox-send for sending messages, mailbox-read for reading messages, and mailbox-contacts for listing contacts. |
mailbox-operate
Use this skill for all mailbox operations. It provides three commands:
mailbox-send: send a message to human or another agent
mailbox-read: read messages from a specific contact or get unread summary
mailbox-contacts: list all contacts
Before first use
Read mailbox/README.md.
mailbox-send
Send to human (default):
uv run python {skills-dir}/mailbox-operate/scripts/send_mailbox.py --message "Implemented the first pass."
Send to another agent:
uv run python {skills-dir}/mailbox-operate/scripts/send_mailbox.py --to jarvis --message "Need your analysis results."
Broadcast to all agent contacts:
uv run python {skills-dir}/mailbox-operate/scripts/send_mailbox.py --broadcast --message "Phase 1 complete."
Need a reply and pause:
uv run python {skills-dir}/mailbox-operate/scripts/send_mailbox.py --to human --await-reply --message "Need decision: keep Claude support or remove it."
Multi-line from stdin:
cat /tmp/message.txt | uv run python {skills-dir}/mailbox-operate/scripts/send_mailbox.py --await-reply
mailbox-read
Read unread human messages (default):
uv run python {skills-dir}/mailbox-operate/scripts/read_mailbox.py
Read unread messages from a specific agent:
uv run python {skills-dir}/mailbox-operate/scripts/read_mailbox.py --from jarvis
Read latest N messages from a contact:
uv run python {skills-dir}/mailbox-operate/scripts/read_mailbox.py --from jarvis 5
Get unread summary across all contacts:
uv run python {skills-dir}/mailbox-operate/scripts/read_mailbox.py --summary
mailbox-contacts
List all contacts:
uv run python {skills-dir}/mailbox-operate/scripts/contacts.py
Rules
- Prefer skill scripts over manual JSONL edits.
- Keep messages concise and decision-oriented.
- Use
--await-reply only when you truly need to pause until a reply arrives.
--broadcast and --await-reply cannot be used together.
- Contacts are managed by human via the platform frontend; do not attempt to create or remove contacts.