multi-model-dispatch

Multi-Model Dispatch

This skill teaches Claude Code how to correctly invoke Codex and Antigravity CLIs for independent review of artifacts. Use this whenever a pipeline step needs multi-model validation at depth 4-5.

When This Skill Activates

• A review or validation step is running at depth 4+ and wants independent model validation
• User asks to "run multi-model review" or "get a second opinion from Codex/Antigravity"
• The automated-pr-review step is using local CLI review mode
• The implementation-plan-review step dispatches to external CLIs at depth 4+

CLI Detection & Auth Verification

Before attempting any dispatch, detect what's available AND verify authentication. A CLI that's installed but not authenticated is useless in headless mode — it will hang on an interactive auth prompt or fail silently.

Step 1: Check CLI Installation

command -v codex && echo "codex installed" || echo "codex not found"
command -v agy && echo "agy installed" || echo "agy not found"

Step 2: Verify Authentication

CRITICAL: Do not skip this step. Auth tokens expire mid-session. A CLI that worked 30 minutes ago may fail now.

CRITICAL: Previous auth failures do NOT exempt subsequent dispatches. Auth tokens refresh — a CLI that failed auth during user story review may work fine for domain modeling review. Always re-check auth before EACH review step, not once per session.

Codex auth check (has a built-in status command):

codex login status 2>/dev/null && echo "codex authenticated" || echo "codex NOT authenticated"

Antigravity auth check (detect auth-failure sentinel text):

AGY_AUTH_CHECK=$(agy -p "respond with ok" --print-timeout 12s 2>&1)
if echo "$AGY_AUTH_CHECK" | grep -qiE "authentication required|authentication timed out"; then
  echo "agy NOT authenticated (auth error)"
else
  echo "agy authenticated"
fi

Antigravity's agy -p "hello" recovery command prints a Google OAuth URL when credentials need refreshing.