dotfiles/.agents/skills/peer-consult/SKILL.md

name, description

name	description
peer-consult	Request an independent, read-only repository review or second opinion from the opposite model provider, using Claude from Codex or Codex from Claude. Use only when the user explicitly asks to consult, ask, review with, or get an opinion from Claude or Codex about an issue, feature, design, plan, diagnosis, or decision. Never invoke proactively. Never use for implementation or file changes.

Peer Consult

Get one independent opinion from the opposite provider. Preserve the repository unchanged and return a standardized decision memo.

Preconditions

• Require an explicit user request for cross-provider consultation. A normal request for review, planning, or advice is insufficient unless it names Claude, Codex, a peer model, or a second opinion.
• Run Claude only when the active agent is Codex. Run Codex only when the active agent is Claude.
• Do not use this skill from any other caller.
• Do not edit files, implement the recommendation, or perform follow-on changes unless the user separately requests them after seeing the memo.

Route the request

Classify the smallest adequate tier:

Tier	Signals	Codex peer	Claude peer
Quick	Narrow, bounded, one component	gpt-5.6-terra, medium	claude-sonnet-4-6, medium
Quick, context-heavy	Still bounded; more context or nuance	gpt-5.6-terra, high	claude-sonnet-5, high
Standard	Multi-file feature, ordinary design/debugging, meaningful trade-offs	gpt-5.6-sol, medium	claude-opus-4-8, medium
Deep	Architecture, concurrency, security, broad ambiguity, high-impact choice	gpt-5.6-sol, high	claude-opus-4-8, high

Honor an explicit model override only when it is allowed for the target provider:

• Codex: gpt-5.6-terra, gpt-5.6-sol
• Claude: claude-sonnet-4-6, claude-sonnet-5, claude-opus-4-8

Reject GPT-5.6 Luna, pre-5.6 Codex models, Claude Haiku, every other Claude model, aliases, and cross-provider model names. Never silently fall back.

Prepare independent context

Write a self-contained request containing:

• The question or decision to assess.
• Relevant constraints and success criteria.
• Relevant paths, symbols, errors, or raw plan text.
• Specific uncertainties the peer should resolve.

Pass raw evidence. Avoid telling the peer the expected answer or presenting the active agent's conclusion as fact. Let the peer inspect the current repository independently.

Run the broker

Resolve <skill-dir> to the directory containing this SKILL.md. Send the request on stdin; do not interpolate it into a shell command.

From Codex:

python3 <skill-dir>/scripts/peer_consult.py \
  --caller codex \
  --complexity standard \
  --repo "$PWD" <<'PEER_REQUEST'
<self-contained consultation request>
PEER_REQUEST

From Claude:

python3 <skill-dir>/scripts/peer_consult.py \
  --caller claude \
  --complexity standard \
  --repo "$PWD" <<'PEER_REQUEST'
<self-contained consultation request>
PEER_REQUEST

Adjust only these routing flags when needed:

• --complexity quick|standard|deep
• --context-heavy for the context-heavy quick tier
• --model <approved-model> for an explicit allowed override
• --timeout <seconds> when the default 600 seconds is unsuitable
• --dry-run to inspect routing and command construction without calling a provider

The broker enforces pinned models, opposite-provider routing, nonpersistent execution, tool restrictions, structured output, and read-only repository access.

Return the result

Return the broker's memo without changing its meaning. Keep its sections:

• Verdict
• Evidence
• Risks
• Alternatives
• Recommendation
• Confidence

Identify it as the peer provider's opinion. If useful, add a short, separately labeled synthesis explaining how the feedback affects the active discussion. Do not implement anything.

On failure, report the selected provider, model, and exact failure. Do not retry with another model unless the user explicitly requests it.