Codex plan critique

Skill adrianleb/codex-plan-critique-skill/skills/codex-plan-critique

Invoke Codex CLI as peer reviewer during planning phases. Use when "planning an implementation", "designing a solution", "in plan mode", "architecting a feature", or about to "propose a plan" to get critique before presenting to user.From its SKILL.md

Install

npx -y skills add adrianleb/codex-plan-critique-skill --skill codex-plan-critique

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

1.7 KB, as published. Nobody here has run it

Codex Plan Critique

Invoke Codex CLI to peer-review plans before presenting to user. Codex runs in the project directory with visibility to all files.

Workflow

Write plan to a temp file (e.g., /tmp/plan-critique.md)
Run critique script with project dir and user prompt
Display critique to user
Incorporate valid concerns into final plan

Running the Critique

scripts/codex-critique.sh <plan-file> <project-dir> "<user-prompt>"

Arguments:

plan-file - Path to plan file
project-dir - Project root (Codex runs here for file access)
user-prompt - Original user request for context

Example:

scripts/codex-critique.sh /tmp/plan.md /Users/ad/myproject "Add user authentication"

Output format:

Verdict: APPROVE or CONCERNS
Strengths: What's good
Concerns: Issues with suggestions

Display Format

Present critique to user:

★ Codex Peer Review ─────────────────────────
[Critique output here]
──────────────────────────────────────────────

Error Handling

If Codex unavailable:

Log warning
Continue without blocking
Note: "Peer review skipped - Codex unavailable"

Requirements

codex CLI installed and authenticated
OPENAI_API_KEY or codex login