Skip to content

skills-codex-claude-review

Category: review
Field: —
License: MIT
Updated: 2026-05-18
Stages: referee-simulation

skills-codex-claude-review

This package is a thin override layer for users who want:

  • Codex as the main executor
  • Claude Code as the reviewer
  • the local claude-review MCP bridge instead of a second Codex reviewer

It is designed to sit on top of the upstream Codex-native package at skills/skills-codex/.

What this package contains

  • Only the review-heavy skill overrides that need a different reviewer backend
  • No duplicate templates or resource directories
  • No replacement for the base skills/skills-codex/ installation

Current overrides:

  • research-review
  • novelty-check
  • research-refine
  • auto-review-loop
  • paper-plan
  • paper-figure
  • paper-write
  • auto-paper-improvement-loop

Install

  1. Install the base Codex-native mirror first:
Bash
bash ~/aris_repo/tools/install_aris_codex.sh ~/your-project
  1. Re-run with the Claude overlay enabled:
Bash
bash ~/aris_repo/tools/install_aris_codex.sh ~/your-project --reconcile --with-claude-review-overlay
  1. Register the local reviewer bridge:
Bash
mkdir -p ~/.codex/mcp-servers/claude-review
cp mcp-servers/claude-review/server.py ~/.codex/mcp-servers/claude-review/server.py
codex mcp add claude-review -- python3 ~/.codex/mcp-servers/claude-review/server.py

If your Claude setup depends on a shell helper such as claude-aws, use the wrapper instead:

Bash
cp mcp-servers/claude-review/run_with_claude_aws.sh ~/.codex/mcp-servers/claude-review/run_with_claude_aws.sh
chmod +x ~/.codex/mcp-servers/claude-review/run_with_claude_aws.sh
codex mcp add claude-review -- ~/.codex/mcp-servers/claude-review/run_with_claude_aws.sh

Why this exists

The upstream skills/skills-codex/ path already supports Codex-native execution with a second Codex reviewer via spawn_agent.

This package adds a different split:

  • executor: Codex
  • reviewer: Claude Code CLI
  • transport: claude-review MCP

For long paper and review prompts, the reviewer path uses:

  • review_start
  • review_reply_start
  • review_status

This avoids the observed Codex-hosted timeout issue when Claude is invoked synchronously through a local bridge.