How do I install the Plan Refine Codex skill?

Run npx skillmds@latest add diegosouzapw/plan-refine-codex in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Plan Refine Codex safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Plan Refine Codex?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Plan Refine Codex free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Plan Refine Codex?

diegosouzapw (@diegosouzapw) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Plan Refine Codex by diegosouzapw — Agent Skill

Name: Plan Refine Codex
Rating: 4.666666666666667 (3 reviews)
Author: diegosouzapw

File contents

Plan Refinement with Codex

Use OpenAI Codex to review and refine implementation plans, adding robustness and catching edge cases.

Prerequisites

codex CLI installed and authenticated (codex login)
A plan file exists (typically at ~/.claude/plans/<name>.md)

Usage

Invocation	Behavior
`/plan-refine-codex`	Refine the current plan file (if in plan mode)
`/plan-refine-codex /path/to/plan.md`	Refine the specified plan file

How to Refine a Plan

Run codex exec with --full-auto and ask it to read and refine the plan file:

codex exec --full-auto "Please read the file $PLAN_FILE and refine the plan. Make it more robust, handle edge cases, and simplify where possible. Return only the improved plan in markdown format."

Important: Have codex read the file itself rather than piping content via stdin. Stdin piping has reliability issues.

Example

codex exec --full-auto "Please read the file /Users/me/.claude/plans/my-plan.md and refine the plan. Look for edge cases like: error handling, input validation, permission issues. Return only the improved plan in markdown format."

Known Issues & Workarounds

Issue: Model not available

ERROR: The 'o3' model is not supported when using Codex with a ChatGPT account.

Workaround: Don't specify -m o3. Use the default model (gpt-5.2-codex).

Issue: Stdin content not received

When piping content via stdin, codex may not receive it:

# This may fail - codex doesn't see the piped content
cat plan.md | codex exec "Refine this plan..."

Workaround: Ask codex to read the file directly in the prompt.

Issue: Heredoc with embedded bash fails

# This fails due to nested $() and backticks
codex exec "$(cat <<'EOF'
...plan with bash code...
EOF
)"

Workaround: Reference the file path instead of embedding content.

Iterating on Refinement

You can pass the plan to codex multiple times for progressive improvement:

First pass: Focus on edge cases and error handling
Second pass: Focus on simplification and clarity
Final pass: Focus on production-readiness

After each refinement, update your plan file with the improved version.

Related Skills

/roborev-review - Get AI code review on your implementation
/roborev-refine - Automated review-fix loop

---name: plan-refine-codexdescription: Refine a Claude Code plan using OpenAI Codex. Use when you have a plan file and want a second opinion or to improve robustness.---# Plan Refinement with CodexUse OpenAI Codex to review and refine implementation plans, adding robustness and catching edge cases.## Prerequisites- `codex` CLI installed and authenticated (`codex login`)- A plan file exists (typically at `~/.claude/plans/<name>.md`)## Usage| Invocation | Behavior ||------------|----------|| `/plan-refine-codex` | Refine the current plan file (if in plan mode) || `/plan-refine-codex /path/to/plan.md` | Refine the specified plan file |## How to Refine a PlanRun codex exec with `--full-auto` and ask it to read and refine the plan file:```bashcodex exec --full-auto "Please read the file $PLAN_FILE and refine the plan. Make it more robust, handle edge cases, and simplify where possible. Return only the improved plan in markdown format."```**Important**: Have codex read the file itself rather than piping content via stdin. Stdin piping has reliability issues.## Example```bashcodex exec --full-auto "Please read the file /Users/me/.claude/plans/my-plan.md and refine the plan. Look for edge cases like: error handling, input validation, permission issues. Return only the improved plan in markdown format."```## Known Issues & Workarounds### Issue: Model not available```ERROR: The 'o3' model is not supported when using Codex with a ChatGPT account.```**Workaround**: Don't specify `-m o3`. Use the default model (`gpt-5.2-codex`).### Issue: Stdin content not receivedWhen piping content via stdin, codex may not receive it:```bash# This may fail - codex doesn't see the piped contentcat plan.md | codex exec "Refine this plan..."```**Workaround**: Ask codex to read the file directly in the prompt.### Issue: Heredoc with embedded bash fails```bash# This fails due to nested $() and backtickscodex exec "$(cat <<'EOF'...plan with bash code...EOF)"```**Workaround**: Reference the file path instead of embedding content.## Iterating on RefinementYou can pass the plan to codex multiple times for progressive improvement:1. **First pass**: Focus on edge cases and error handling2. **Second pass**: Focus on simplification and clarity3. **Final pass**: Focus on production-readinessAfter each refinement, update your plan file with the improved version.## Related Skills- `/roborev-review` - Get AI code review on your implementation- `/roborev-refine` - Automated review-fix loop

Frequently asked questions

Plan Refine Codex