Claude Skills by Ryan-M-Frank

Diagnose the Volley environment in one shot - Codex CLI, the bundled MCP bridge, the platform terminal, and the per-repo lock state. Use when setup misbehaves or before starting a session in a new repo.

Use when a plan is ready to build and you want Codex to implement it. Spawns a visible Windows Terminal tab running Codex with a pre-built prompt that points it at the plan and tells it to log progress to .volley/IMPLEMENTATION-LOG.md. Sets the STATE lock to ACTIVE=codex so Claude won't touch source files until Codex finishes. Returns control to the user with a clear "watch the tab" message.

Use after Codex has implemented a plan. Claude reviews the diff (defaults to uncommitted changes; accepts a git revision range as argument), checks it against PLAN.md and acceptance criteria, and writes a verdict to .volley/CODE-REVIEW.md. Inline review - does not call Codex.

Use to send a plan document to Codex for review via MCP. Defaults to the most recently modified PLAN.md under .planning/, or accept an explicit path argument. Codex's review is written to .volley/PLAN-REVIEW.md and surfaced inline. Fast - completes in seconds.

Use to send a GitHub PR's diff to Codex for review via MCP. Required argument is the PR number. Output written to .volley/PR-REVIEW-<num>.md and shown inline. Asks for explicit user opt-in before posting as a PR comment.

Use to initialize the Volley Claude+Codex workflow in this repo. Runs once per repo. Verifies Codex is installed, confirms the bundled Codex MCP server is reachable, scaffolds .volley/ with HANDOFF.md template, .gitignore, and an initial STATE file. Runs a smoke test that calls Codex via MCP.

Use to inspect the current Volley lock state. Reports who's active, what task they're on, lock age, whether the named PID is still alive, and lists the most recent .volley/ review files. Use to confirm Codex finished, to check for stale locks, or any time you're unsure whose turn it is.

Use to force-clear the Volley STATE lock when something has gone wrong - Codex's terminal crashed, was closed, or otherwise left STATE in a bad state. Confirms with the user before clearing. The escape hatch from the concurrency model.