agentleFS
ThibautBaissacThibautBaissac/rails_ai_agents/.agents/skills/codex-review/SKILL.md

codex-review

Skill665 starsChanged 6 months agoMITView on GitHub

Get an independent second opinion from OpenAI Codex CLI on a plan, diff, spec, or Claude's last response. Use when the user asks to "get a second opinion", "have codex review", "cross-check with codex", or wants adversarial review of Claude's output. Argument is one of plan|diff|spec|last-response (default last-response).

94 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use addskill, apply-firmware and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • ryanportfolioSkill

    addskill

    Create, import, update, or install repo or personal skills: runtime ownership, resources, discovery checks.

    Also in 6 projects that use this

  • ryanportfolioSkill

    apply-firmware

    Bring current folder (plain folder, existing repo, old or partial firmware copy) up to full Harness Firmware in place. Mirror external repo → adopt-repo.

    Also in 6 projects that use this

  • +10 more from ryanportfolio

The file

We split this skill into the rules it gives an agent

8 rules. 0 are common, 4 are distinctive, and 4 are very specific to this project.

  • 0

    Common

    Most of the 81 edited versions we read keep these.

  • 4

    Distinctive

    This author's own choices. Worth a look.

  • 4

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Never fall back to reviewing Claude's own output if Codex fails.

    line 22
  2. Distinctive:

    Run in order. Stop cleanly on first failure:

    line 26
  3. Very specific:

    plan: if there is an active in-conversation plan, write it to a temp file as above.

    line 36
  4. Very specific:

    diff: no file needed — Codex reads the repo directly via codex review --uncommitted.

    line 38
  5. Very specific:

    Use a single Bash call with 600000ms timeout.

    line 60
  6. Distinctive:

    Stop after emitting failure.

    line 93
  7. Distinctive:

    After a successful review, end your turn with one question to the user:

    line 97
  8. Very specific:

    Only if the user says yes, produce a ### Reconciliation section with three bullet lists: Adopt, Reject (each with a one-line reason), Defer …

    line 101

“Common” is measured: kept by at least 6 in 10 of the 81 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

/codex-review — Independent second opinion from Codex CLI

Argument: $ARGUMENTS — one of plan | diff | spec | last-response. Default last-response.

Never fall back to reviewing Claude's own output if Codex fails. If Codex can't run, say so and stop.

1. Preflight

Run in order. Stop cleanly on first failure:

command -v codex >/dev/null 2>&1 || { echo "codex CLI not found. Install: https://github.com/openai/codex"; exit 0; }
codex login status 2>&1 | grep -qi "logged in" || { echo "codex not logged in. Run: codex login"; exit 0; }

2. Resolve target

  • last-response (default): identify your previous substantive assistant turn (the last turn with user-facing prose — skip turns that are pure tool calls or tool results). Write that prose verbatim to a temp file via the Write tool: $(mktemp -t codex-review).md. Record the path as $TARGET_FILE.
  • plan: if there is an active in-conversation plan, write it to a temp file as above. Otherwise pick the newest file under ./.claude/plans/ (ls -t ./.claude/plans/*.md 2>/dev/null | head -1). If neither exists, report "no plan found" and stop.
  • spec: pick the newest spec.md under ./specs/ (fd -t f 'spec\.md$' ./specs 2>/dev/null | xargs ls -t 2>/dev/null | head -1). If none, stop.
  • diff: no file needed — Codex reads the repo directly via codex review --uncommitted.

3. Build rubric (skip for diff)

The diff target uses codex review's built-in review prompt — do not pass a custom rubric there (--uncommitted is mutually exclusive with [PROMPT] and will error).

For plan | spec | last-response, write this rubric to $(mktemp -t codex-rubric).txt:

You are an adversarial reviewer giving a second opinion. Be terse. Do not restate what is correct.

Check, in order:
1. Correctness — logic errors, off-by-one, wrong APIs, broken invariants.
2. Missing edge cases — nulls, empty inputs, concurrent writes, partial failures, auth gaps.
3. Simpler alternatives — is there a shorter, more conventional, or better-supported approach?
4. Risk — blast radius, reversibility, data loss, security implications.

Output format: 4 sections with those exact headings. Skip a section if you have nothing material. No preamble, no summary, no praise.

4. Invoke Codex

Use a single Bash call with 600000ms timeout. Capture stdout and exit code. Do not pass -c model=... — rely on the user's ~/.codex/config.toml defaults.

  • diff:
    codex review --uncommitted
  • plan | spec | last-response:
    { printf '=== CONTENT TO REVIEW ===\n'; cat "$TARGET_FILE"; printf '\n\n=== REVIEW INSTRUCTIONS ===\n'; cat "$RUBRIC_FILE"; } \
      | codex exec --sandbox read-only --skip-git-repo-check -

Pass all content via stdin. Never put file contents on argv.

5. Emit review

On exit code 0:

### Codex Review

<codex stdout verbatim — no edits, no paraphrase>

On non-zero exit or timeout:

### Codex Review (FAILED)

Codex exited with status <N>. Stderr tail:
<last 20 lines of stderr>

Stop after emitting failure. Do not substitute your own review.

6. Ask before reconciling

After a successful review, end your turn with one question to the user:

Want me to reconcile — decide which points to adopt, reject, or defer?

Only if the user says yes, produce a ### Reconciliation section with three bullet lists: Adopt, Reject (each with a one-line reason), Defer (each with a one-line reason to revisit later). Do not rubber-stamp Codex; reject points that are wrong or off-scope.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.