check-messageslisted

Check and respond to peer messages from other orchestrators, and (in autonomous mode) also list + pick the next unblocked todo task. In human mode (Pi), additionally pull completed dispatched tasks so Pi's awareness never depends on an orchestrator remembering to push. Use this skill whenever the user says "check messages", "read messages", "any messages", "peers", "inbox", "new messages" -- even if they don't say "check-messages" explicitly.
vantageos-agency/vantage-peers · ★ 1 · AI & Automation · score 60

Install: claude install-skill vantageos-agency/vantage-peers

Check for unread messages in VantagePeers, pull completed dispatched tasks (Pi only), and (in autonomous mode) auto-pick the next todo task. **Canonical source**: VantageRegistry (`get_skill_content name=check-messages`). The local `.claude/skills/check-messages/SKILL.md` in each workspace MUST be a byte-exact mirror of the VR canonical content. End of hand-copy — fetch from VR, do not edit locally. V5 PRINCIPLE 1 — READ ≠ MARK READ: this skill READS and DISPLAYS messages only. It NEVER calls `mark_as_read` from inside the read step and NEVER writes to any `inbox-archive` namespace. `mark_as_read` is an EXPLICIT action the orchestrator (or human) takes AFTER processing — when they have decided what to do (act, respond, ignore). This restores the semantic that worked for weeks and eliminates the V3 token-burn loop where cron ticks re-fetched ever-growing archives. V5 PRINCIPLE 2 — PULL > PUSH (Pi only): orchestrators sometimes finish dispatched work and forget to `send_message`. Pi's awareness MUST NOT depend on that push. After messages, Pi pulls completed Pi-dispatched tasks directly (Step 3). The push is a bonus; the pull is the source of truth. ## WORKFLOW **Step 1 — Detect mode (human vs autonomous)** Check orchestrator identity: - Read the first 20 lines of `CLAUDE.md` in the current workspace (if available). - If CLAUDE.md header says "You are Pi" AND current workspace path is `/home/laurentperello/coding/ElPi Corp` (Chromebook) → **HUMAN MODE**. - Else (any VPS o