personal-codex-review

Runs read-only Codex CLI reviews of branch diffs, commits, or uncommitted changes and returns findings.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/kosako/agent-tools --skill personal-codex-review-kosako
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: personal-codex-review
Source: https://github.com/kosako/agent-tools/tree/main/shared/skills/personal-codex-review
Command: npx skills add https://github.com/kosako/agent-tools --skill personal-codex-review-kosako

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It provides a safe, deterministic way to get a Codex CLI second opinion or cross-review on code changes without giving the reviewer any write access to the repository or GitHub, while enforcing author-versus-reviewer independence rules. ## Core Features & Use Cases - Capability-checked read-only execution: Verifies codex exec supports -s read-only, -c, -o, and stdin prompts before launching, and blocks with a structured BLOCKED result instead of falling back to unsafe flags. - Verified target identity: Confirms local HEAD, base ref, and a clean worktree match caller-supplied expected OIDs before reviewing, with shell-literal escaping and --end-of-options to prevent option injection. - Author guard and independence labeling: Accepts only verified Claude-authored cross-review routes or explicit second opinions (labeled non-independent), and fails closed to human adjudication for mixed or unknown authors. - Use Case: A PR workflow routes a verified Claude-authored branch to Codex for cross-review; this skill launches codex exec from a herdr pane, waits on a nonce-marked done file, and returns a verdict with severity-tagged findings. ## Quick Start Ask the agent to run a Codex second-opinion review of the current uncommitted changes and return the verdict and findings.

Frequently Asked Questions about personal-codex-review

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

FAQPage Schema
How do I run a Codex CLI review of uncommitted changes?▼

Verify codex exec supports -s read-only, -c, -o, and stdin prompts, then write a brief file specifying uncommitted mode with git status --porcelain, git diff --cached, and git diff. Launch codex exec from a herdr pane and read the result file after the nonce-marked done file confirms exit=0.

How does this skill enforce code review independence?▼

It only runs cross-review when a trusted deterministic preflight verifies author=claude and reviewer=codex. Codex-authored changes are routed back to Claude, mixed or unknown authors go to human adjudication, and explicit second opinions are labeled second-opinion only, never independent approval.

Can Codex review a pull request branch diff safely?▼

Yes, via base mode: the caller supplies expected base and head OIDs, and the skill verifies local HEAD, the base ref via check-ref-format and rev-parse with --end-of-options, and a clean worktree before reviewing. It never checks out, fetches, resets, or mutates the worktree itself.

What happens when the Codex CLI lacks required flags?▼

The skill returns Status: BLOCKED with Blocked at: capability-preflight instead of guessing flags or substituting pane output for the result file. It hands off to a verified reviewer route or a human, and never modifies user configuration.

Why does the review block when herdr is unavailable?▼

Inside a Claude Code or Codex sandbox, nested sandboxes are impossible, so codex exec cannot run commands. Without herdr and without verifiable unsandboxed settings (including managed settings), the skill blocks at launch-path and hands a manual run script to a human.

What are the limitations of this review executor?▼

It performs no GitHub reads, comments, approvals, or merges, and no repository writes; the PR lifecycle belongs to the caller. Its verdict covers only the code review process, not CI, required checks, or overall merge readiness.