diff --git a/skills/paseo-chat/SKILL.md b/skills/paseo-chat/SKILL.md index 5b0864ca9..b77d59635 100644 --- a/skills/paseo-chat/SKILL.md +++ b/skills/paseo-chat/SKILL.md @@ -121,10 +121,12 @@ 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 `@agent-id` when you want to get a specific agent's attention +- use `@agent-id` when you want to get a specific agent's attention — but know that mentions **interrupt** the target agent immediately, so only mention when they need to act now - use `@everyone` sparingly when you want all prior participants in the room to respond or re-check the thread - prefer `@agent-id` most of the time so you only interrupt the agents who actually need the message +- if a normal post is enough and no one needs to act right now, skip the mention — agents will see it next time they read the room - check chat frequently enough that shared coordination actually works +- your own agent ID is available via `$PASEO_AGENT_ID` — when someone asks you to report back, mention them so they get notified Typical things to post: - status updates diff --git a/skills/paseo-orchestrator/SKILL.md b/skills/paseo-orchestrator/SKILL.md index 8d1a14366..da1c8d0a3 100644 --- a/skills/paseo-orchestrator/SKILL.md +++ b/skills/paseo-orchestrator/SKILL.md @@ -64,6 +64,7 @@ When you launch planning, implementation, investigation, or review agents and ch - require them to add their findings to the room - require them to read recent chat before acting - require them to post back when they discover something another agent may need +- if you expect a response back (review findings, audit results, blocker reports), tell the agent to `@mention` you when done — your agent ID is `$PASEO_AGENT_ID` (check it with `echo $PASEO_AGENT_ID` if needed) and include it literally in the prompt so the agent knows who to tag Chat is not just passive storage. Mentions and replies trigger direct notifications through chat, so agents can actively get each other's attention.