Oracle Codex

Invoke the Codex CLI for planning and code-review analyses.

82|12|Updated Aug 31, 2025
One-click install
npx skills add https://github.com/PaulRBerg/dot-claude --skill oracle-codex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Oracle Codex
Source: https://github.com/PaulRBerg/dot-claude/tree/main/skills/oracle-codex
Command: npx skills add https://github.com/PaulRBerg/dot-claude --skill oracle-codex

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires codex, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill enables you to use OpenAI Codex CLI as a planning oracle and code reviewer. It provides analysis and recommendations, while Claude synthesizes and presents them. It is strictly for planning and review; do not use Codex to implement changes.

Core Features & Use Cases

  • Planning advisor: Generate architecture and implementation plans without changing code.
  • Code review aide: Get insights on design, safety, and maintainability before coding.
  • Use Case: When you need a second opinion or an architectural plan for a feature, without touching the codebase yet.

Quick Start

Run the Codex planning workflow to analyze the target codebase and provide a high-level plan. Example: "~/.claude/skills/oracle-codex/scripts/check-codex.sh" to verify Codex CLI is installed, then invoke codex with a planning prompt. Use this skill to gather design recommendations before writing code.

Frequently Asked Questions about Oracle Codex

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I use Codex for architecture planning without implementing changes?

Oracle Codex invokes the Codex CLI as a planning oracle to analyze your codebase and generate architecture plans, feature designs, and risk assessments. It provides recommendations through structured analysis while Claude synthesizes results—no code modifications occur.

Can I use Codex CLI for multi-file code reviews and security evaluations?

Yes. Oracle Codex applies Codex CLI to conduct multi-file code reviews, assess design patterns, evaluate maintainability, and identify security concerns across your codebase. It surfaces insights for your review before any implementation work.

What prerequisites do I need to run Oracle Codex for planning?

You must have the Codex CLI installed and configured. Oracle Codex enforces prerequisites validation, timeout guidelines, model selection, and sandbox mode before executing planning prompts, ensuring safe oracle-mode operation.

How do I get started with Codex planning workflows?

Run the verification script at `~/.claude/skills/oracle-codex/scripts/check-codex.sh` to confirm Codex CLI installation. Then invoke codex through Oracle Codex with a planning prompt targeting your codebase for architectural or design recommendations.

What's the difference between using Codex for planning versus implementation?

Oracle Codex strictly restricts Codex to planning, review, and analysis roles—generating strategies and feedback without executing code changes. This separation ensures you gather insights and validate designs before committing implementation work.

Does Oracle Codex work with existing automation and CLI workflows?

Yes. Oracle Codex integrates Codex CLI into planning and review pipelines, supporting automation through scripts and structured output with attribution, making it compatible with existing code-review and planning workflows.