codex-plan-review SKILL.md skillA

codex-plan-review from jasonm4130/claude-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add jasonm4130/claude-skills/codex-plan-review@git:20260929.0b2c937

Pins git:20260929.0b2c937 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
jasonm4130/claude-skills
Path
plugins/codex-review/skills/codex-plan-review/SKILL.md
Versions recorded
10
Latest version
git:20260929.0b2c937, committed Sep 29, 2026
First version recorded
Aug 2, 2026
Size
14,528 bytes
Repository stars
5
License
MIT

Cross-provider adversarial review of a finalized plan, spec, design doc, ADR, or code diff using OpenAI Codex (GPT-6 Sol), paired in round 1 with a blind Opus reviewer. AUTO-TRIGGER at plan gates — invoke immediately after any of: (1) a plan or spec is finalized, (2) an ADR draft is completed. AUTO-TRIGGER for code: after implementing a Codex-reviewed plan, run diff mode on the branch range before opening the PR — a reviewed plan is NOT a reviewed diff. Also invoke on request —…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Codex Plan Review

Send a finalized plan/spec/design/ADR to OpenAI Codex (`gpt-6-sol`, medium effort, read-only sandbox) for adversarial review, with a blind Opus reviewer running the same prompt in parallel for round 1. The script handles mechanics; you handle judgment. Script path (resolve via this skill's base directory): `scripts/codex-review.mjs`, run with `node`.

**The one non-negotiable prompt rule:** the reviewer must never see your self-assessment. The script builds prompts from the file path only — never paste plan content, your confidence, or "tests pass" claims into any codex invocation. (Research: implementer framing degrades Codex review thoroughness 3–4×.)

## Flow

1. **Announce:** "Running Codex plan review (Sol, medium effort) plus a blind Opus reviewer (medium) — round 1." `gpt-6-sol` needs Codex CLI 0.158+ on a ChatGPT login (older clients do not list it); if a round returns `verdict:"error"` and its `errorDetail` says the model is unavailable, close that chain (`note --chain <id> --unique 0 --outcome aborted --comment "model unavailable"`; an aborted chain does not block a new one), then rerun with `--model <available model>` and say which. If `codex` is…
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add jasonm4130/claude-skills/codex-plan-review@sha256:700d4a783d056d49

The line at the top of this page pins the label git:20260929.0b2c937, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_btgd7hsi2admcgjk.svg)](https://markdownregistry.com/a/art_btgd7hsi2admcgjk)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 10 versions of this file, between Aug 2, 2026 and Sep 29, 2026, about one every 6 days.

versioncommittedcommitsizeaudit
git:20260929.0b2c937 latest2026-09-29 0b2c937 14,528 BA view · diff
git:20260929.d7974c32026-09-29 d7974c3 14,433 BA view · diff
git:20260929.d82f88b2026-09-29 d82f88b 14,251 BA view · diff
git:20260929.bb17e292026-09-29 bb17e29 13,238 BA view · diff
git:20260914.a6fa37e2026-09-14 a6fa37e 10,908 BA view · diff
git:20260905.bb18b9c2026-09-05 bb18b9c 10,929 BA view · diff
git:20260809.380c3e52026-08-09 380c3e5 11,026 BA view · diff
git:20260809.11db76f2026-08-09 11db76f 11,012 BA view · diff
git:20260809.a0b36492026-08-09 a0b3649 11,009 BA view · diff
git:20260802.fc920a52026-08-02 fc920a5 10,929 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (14528 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

jasonm4130/claude-skills · 5 stars · license MIT · pushed 2026-10-18 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_btgd7hsi2admcgjk
GET https://markdownregistry.com/api/v1/resolve?ref=jasonm4130/claude-skills/codex-plan-review
GET https://markdownregistry.com/api/v1/blob/700d4a783d056d49e5734774a66d8a8a19f002151d3501b476f4076173f6b065

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from jasonm4130/claude-skills

domain-modeling SKILL.md skill
jasonm4130/claude-skills · plugins/domain-modeling/skills/domain-modeling/SKILL.md · Use when pinning down domain terminology, building a ubiquitous language or project glossary, disambiguating overloaded…
git:20260914.e17e16a · audit A · 5 stars
CLAUDE.md@plugins/gates CLAUDE.md file
jasonm4130/claude-skills · plugins/gates/CLAUDE.md
git:20261016.22838ed · audit A · 5 stars
docs-consolidate SKILL.md skill
jasonm4130/claude-skills · plugins/gates/skills/docs-consolidate/SKILL.md · Audit a repo's documentation for internal contradictions, stale claims, orphans and bloat after it has accumulated…
git:20260826.6b5d3b6 · audit A · 5 stars
CLAUDE.md@plugins/handoff CLAUDE.md file
jasonm4130/claude-skills · plugins/handoff/CLAUDE.md
git:20260826.13bf801 · audit A · 5 stars
handoff SKILL.md skill
jasonm4130/claude-skills · plugins/handoff/skills/handoff/SKILL.md · Write a structured handoff / resume document for this session so the next session can pick up exactly where this one…
git:20260830.df950a0 · audit A · 5 stars
readme SKILL.md skill
jasonm4130/claude-skills · plugins/writing-artifacts/skills/readme/SKILL.md · Use when writing, auditing or revising a project's README.md, including its badge row. Grounds every claim in a…
git:20261016.2eafc2c · audit A · 5 stars
writing-artifacts SKILL.md skill
jasonm4130/claude-skills · plugins/writing-artifacts/skills/writing-artifacts/SKILL.md · Use when writing or revising a durable written artifact — README, ADR, design doc, PR description, release notes…
git:20260830.df950a0 · audit A · 5 stars

Every file in jasonm4130/claude-skills

Other files named codex-plan-review

codex-plan-review SKILL.md skill
tykisgod/quick-question · skills/codex-plan-review/SKILL.md · Send a design document to Codex CLI for review, then revise the document based on the findings. Automatically loops…
git:20261012.61e472c · audit B · 12 stars

Browse by kind, by grade A, or by owner.