| name | chat |
| description | Post messages to the team chat log (agents/CHAT.md). Use to communicate between personas, log progress updates, and coordinate handoffs. |
| triggers | ["*msg","*chat log"] |
Chat Skill
Overview
The chat skill posts structured messages to agents/CHAT.md, the shared team communication log. All personas use this to coordinate work and hand off tasks.
Usage
make chat MSG="<message>" [PERSONA="<Name>"] [CMD="<command>"] [TO="<recipient>"]
Arguments
| Argument | Make Variable | Default | Description |
|---|
| message | MSG | required | Message content |
| persona | PERSONA | $USER | Who is sending (e.g. Neo, Trin) |
| cmd | CMD | chat | Command prefix (auto-prefixed with *) |
| to | TO | all | Recipient persona name |
Output Format
[DATETIME] [**Persona**]->[**recipient**] *cmd*:
message
Examples
Log a user request
make chat MSG="fix the bug in parser.py" PERSONA="User" CMD="request"
Post a persona response
make chat MSG="Fixed bug in parser.py line 42" PERSONA="Neo" CMD="swe fix" TO="Trin"
Assign work to another persona
make chat MSG="@Trin please verify the fix in parser.py" PERSONA="Neo" CMD="handoff" TO="Trin"
When to Post
- ENTRY: After reading CHAT.md to acknowledge context
- WORK: After completing each significant step
- HANDOFF: When switching to another persona — assign the next task explicitly
- EXIT: Before saving state files
Reading the Chat Log
Always read agents/CHAT.md (newest messages at the END) before starting work:
Read agents/CHAT.md # last 10-20 messages for context
