ask-peer-clarification

Asks a peer agent one read-only question to enrich a detected platform anomaly before escalation.

2|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/witwave-ai/witwave --skill ask-peer-clarification-witwave-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ask-peer-clarification
Source: https://github.com/witwave-ai/witwave/tree/main/.agents/self/mira/.claude/skills/ask-peer-clarification
Command: npx skills add https://github.com/witwave-ai/witwave --skill ask-peer-clarification-witwave-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a monitoring agent detects a platform anomaly pointing at a specific peer, external evidence alone often cannot explain the cause, leading to speculative or incomplete escalation handoffs. This Skill provides a disciplined way to ask that peer one focused, read-only question so the escalation includes the peer's subjective context. ## Core Features & Use Cases - Read-First Gating: Enforces a checklist (peer memory files, decision logs, git history, pod logs, snapshot history) and three gates before any question is sent, keeping peer interruptions rare. - Structured call-peer Framing: Provides a prompt template that explicitly requests information only, never delegated work, with a 50-word reply limit and a timeout recommendation. - Handoff Integration and Audit Logging: Folds the peer's reply into the Zora escalation under peer_followup.responses and appends the question/response round-trip to the daily snapshot JSONL for auditability. - Use Case: Mira observes Evan's pod restarted with OOMKilled at 14:32Z; after the read-first checklist comes up empty, she asks Evan whether he ran anything heavy then, and includes his answer in the handoff to Zora. ## Quick Start Ask the peer agent Evan one read-only clarifying question about the OOMKilled restart anomaly and include his reply in the Zora handoff.

Frequently Asked Questions about ask-peer-clarification

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

FAQPage Schema
How do I ask a peer agent a clarifying question without delegating work?▼

Use the provided call-peer prompt template that explicitly states the request is information-only, includes the observed anomaly and one question, and caps the reply at 50 words. The framing tells the peer to answer briefly rather than launch a skill or take action.

When should I use ask-peer-clarification instead of call-peer directly?▼

Use it only when a detected platform anomaly points at one specific peer and external evidence cannot explain the cause. Direct call-peer is for delegating work; this skill is strictly for read-only subjective context during platform-health Step 8, never routine polling.

What checks must pass before sending a peer clarification question?▼

First complete the read-first checklist: the peer's MEMORY.md index and findings, decision logs, recent git history, pod logs for the time window, and prior snapshots. Then all three gates must pass: the information is critical, underivable from read sources, and the peer is the authoritative source.

What happens if the peer has no context on the anomaly?▼

Proceed with the Zora handoff using external evidence alone, and note in the handoff that the peer was asked but had no additional context. This tells Zora the external evidence represents the full picture.

Can I ask a peer multiple follow-up questions about one anomaly?▼

No. The skill allows one question per anomaly. If the first reply raises further questions, hand off to Zora with what you have and let her route a richer follow-up through the appropriate peer.