ask-peer
Installation
SKILL.md
Peer Engineer Consultation
Get a second opinion from a peer engineer using the current host's reviewer-dispatch mechanism, with an inline fallback when dispatch is unavailable.
Process
- Select mode, then dispatch immediately: First classify your execution host and tool surface.
- Claude Code path: when the
Agenttool is exposed and nested dispatch is not blocked, dispatch withAgent(applying the optionalModel:value per the OptionalModel:bullet below as theAgentmodelparameter when present; omit when absent). - Codex path: when Codex exposes a subagent / delegation mechanism in the current session, dispatch through that mechanism.
- Fallback path: if no host-provided reviewer dispatch is available — the
Agenttool is absent from your tool surface, or the host indicates before dispatch that reviewer dispatch cannot recurse — skip dispatch and produce the feedback inline on the main thread by adopting the Peer Agent Personality below. Being invoked as a sub-skill (e.g. viaSkill()on the main thread) does not by itself trigger this path: decide by whetherAgentis exposed and callable, not by invocation lineage — if it is, take the Claude Code path. The deliverable is the feedback content, not the dispatch mechanism. - No status-only turn: reading this SKILL.md is preparation, not dispatch. Do not produce a "consulting peer" / "waiting for results" status message without a concurrent dispatch tool call in the same turn.
- Parallelism: if the request contains multiple independent review categories and the host supports parallel reviewer dispatch, spawn one reviewer per category in parallel. Otherwise, spawn a single reviewer or run the categories inline sequentially under the fallback path.
- Optional
Model:: the consultation request may carry an optionalModel:value — one of the model ids the currentAgenttool'smodelparameter accepts (sonnet/opus/haiku/fableas of this writing; check the tool's live schema loaded in the current session rather than this fixed list, since Anthropic adds new model families over time) — an independent optional field a caller (e.g.dev-workflow) passes to run the review on a specific model. Apply it as themodelparameter on the Claude Code pathAgentdispatch (including each parallel reviewer dispatch). It is moot on the Codex / fallback (inline) paths — noAgentis spawned there, so the executing agent's own model governs. Absent → inherit the session model (backward-compatible; existing callers that pass noModel:are unaffected).
- Claude Code path: when the
- Each reviewer receives the peer personality below + the full consultation request including all caller instructions
- For parallel reviews, merge results in category order as unified feedback
- Present the peer's feedback to the user