puter/paseo
1
0
Fork 0
mirror of https://github.com/getpaseo/paseo.git synced 2026-07-29 12:01:31 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs(skills): add @mention guidance for chat notifications

Browse Source 
Orchestrator skill: tell agents to @mention you when you expect a
response back, using $PASEO_AGENT_ID. Chat skill: clarify that
mentions interrupt immediately, so use them deliberately.
This commit is contained in:
Mohamed Boudra
2026-03-24 21:53:01 +07:00
parent 535774a235
commit 8c49f74fd9
2 changed files with 4 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
skills/paseo-chat/SKILL.md
View File

@@ -121,10 +121,12 @@ When using a room:
- read only a bounded window before acting - read only a bounded window before acting
- post updates when they would help another agent or your future self - post updates when they would help another agent or your future self
- use `--reply-to` when responding to a specific message - 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 - 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 - 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 - 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: Typical things to post:
- status updates - status updates

1
skills/paseo-orchestrator/SKILL.md
View File

@@ -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 add their findings to the room
- require them to read recent chat before acting - require them to read recent chat before acting
- require them to post back when they discover something another agent may need - 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. Chat is not just passive storage. Mentions and replies trigger direct notifications through chat, so agents can actively get each other's attention.