notify-peer-sessions

Compose and send verified messages to peer agent sessions via ListAgents and SendMessage.

Updated Dec 25, 2021
One-click install
npx skills add https://github.com/kotahashihama/dotfiles --skill notify-peer-sessions-kotahashihama
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notify-peer-sessions
Source: https://github.com/kotahashihama/dotfiles/tree/main/home/.claude/skills/notify-peer-sessions
Command: npx skills add https://github.com/kotahashihama/dotfiles --skill notify-peer-sessions-kotahashihama

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When multiple AI sessions work on different repositories, messages between them often contain unverifiable claims, misattributed statements, or procedures that fail outside their original context. This Skill defines how to assemble and send inter-session messages so the receiving session can verify facts, trace attribution, and act on shared procedures correctly. ## Core Features & Use Cases - Verifiable fact delivery: Distinguishes facts the peer can confirm (pushed commits, PRs, CI results) from local-only observations, and requires commit SHAs when reporting on moving branches. - Attribution discipline: Prevents mixing your own observations with the peer's words by checking original messages before quoting or thanking, including checking the from field when multiple sessions reply. - Scoped procedure handoff: Requires attaching applicability conditions and tested environments when passing commands or recovery steps to another session. - Use Case: After finishing a cross-repository change, you notify the session owning the dependent repository with the merged commit SHA, a 3-5 line status summary, and a query about their merge timeline using SendMessage. ## Quick Start Ask the agent to notify the peer session responsible for the other repository about the completed change, including the commit SHA and current status.

Frequently Asked Questions about notify-peer-sessions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send a message to another Claude agent session?

Use ListAgents to find the target session, then SendMessage to deliver the message. If the session name is not unique, append a [ref] to disambiguate the recipient.

What facts can I safely state as confirmed to a peer session?

Only facts the peer can independently verify, such as pushed commits, merged history, PRs, CI results, and API responses. Local-only state like unpushed changes must be explicitly labeled as unverifiable by the peer.

Why should I include a commit SHA when reporting branch status?

Branch names are moving targets, so the peer may observe a different commit than you did. Attaching the observed SHA ensures the peer can reproduce your exact observation point.

How do I avoid misattributing statements between sessions?

Re-read the original message before quoting or thanking a peer, and check the from field when multiple sessions replied in the same turn. Present your own wording as your own rather than attributing it to the peer.

When should I share overall status with a peer session?

Share a 3-5 line summary whenever you report a milestone to the user, even if the peer's actions do not change. This keeps the peer session informed as the user's window into that repository.