paseo/skills/paseo-chat/SKILL.md

name, description, user-invocable

name	description	user-invocable
paseo-chat	Use chat rooms through the Paseo CLI. Use when the user says "chat room", "room", "coordinate through chat", "shared mailbox", or wants agents to communicate asynchronously.	true

Paseo Chat Skill

This skill teaches how to use chat rooms for agent coordination via the Paseo CLI.

User's arguments: $ARGUMENTS

---

Prerequisites

Load the Paseo skill first if you need CLI guidance for launching or messaging agents.

Rules

When using chat:

• create a room with paseo chat create if you need a new room
• inspect available rooms with paseo chat ls and paseo chat inspect
• post with paseo chat post
• read with paseo chat read
• keep reads bounded, usually --limit 10 or --limit 20
• check chat often while working

Mentions are active:

• use --mention <agent-id> on your post to notify a specific agent immediately
• if you use --reply-to, the author of the replied-to message is notified
• notifications are sent via paseo send --no-wait under the hood
• mentions interrupt the target agent, so only mention when they need to act now
• if a normal post is enough and no one needs to act right now, skip the mention

Command Surface

Create a room

paseo chat create issue-456 --purpose "Coordinate implementation and review"

List rooms

paseo chat ls

Inspect room details

paseo chat inspect issue-456

Post a message

paseo chat post issue-456 "I traced the failure to relay auth. Investigating config loading now."

With a reply:

paseo chat post issue-456 "I can take that next." --reply-to msg-001

With a direct mention:

paseo chat post issue-456 "Can you verify the relay path next?" --mention <agent-id>

Read recent messages

paseo chat read issue-456 --limit 10

Filter reads

paseo chat read issue-456 --agent <agent-id>
paseo chat read issue-456 --since 5m
paseo chat read issue-456 --since 2026-03-24T10:00:00Z

Wait for new messages

paseo chat wait issue-456 --timeout 60s

Defaults

When creating a room:

• choose a short slug: issue-456, pr-143-review, relay-cleanup
• give it a clear purpose

When using a room:

• read only a bounded window before acting
• post updates when they would help another agent or your future self
• use --reply-to when responding to a specific message
• use --mention when you want to get a specific agent's attention — but know that mentions interrupt the target agent
• check chat frequently enough that shared coordination actually works
• your own agent ID is available via $PASEO_AGENT_ID

Typical things to post:

• status updates
• blockers
• handoffs
• review findings
• important context another agent may need later

Your Job

1. Understand whether you should use an existing room or create a new one
2. Create the room with paseo chat create if needed
3. Read the room with bounded history
4. Post clearly
5. Use --reply-to when replying to a specific message
6. Use --mention when you want to notify someone directly