Sandbox
@skills-directory/skill-codex

Claude Code skill for Codex delegation

This package adds a Claude Code skill that shells out to the Codex CLI for code analysis, refactoring, and editing. It works as either a Claude Code plugin or a copied standalone skill, and the skill instructions live in the Codex skill folder.

1,433 stars110 forksUpdated 1mo ago
Who it's for

Builders who use Claude Code and want Codex to handle analysis or edits from inside their workflow.

What it delivers

You can hand a prompt to Codex from Claude Code and get back summarized results without leaving the session.

What it does

Codex CLI delegation

Runs `codex exec` from Claude Code so Codex can analyze, refactor, or edit code.

Session resume support

Uses Codex session resumes for follow-up work instead of starting over.

Plugin installation

Ships as a Claude Code plugin with a marketplace entry for automatic updates.

Standalone skill install

Can be extracted into `~/.claude/skills/codex` if you do not want the plugin path.

Model and effort selection

Prompts for a Codex model and reasoning effort unless you already specify them.

How to get it

  1. 1Install via Claude Code's plugin system for automatic updates
    /plugin marketplace add skills-directory/skill-codex
    /plugin install skill-codex@skill-codex
  2. 2Extract the skill folder manually
    git clone --depth 1 git@github.com:skills-directory/skill-codex.git /tmp/skills-temp && \
    mkdir -p ~/.claude/skills && \
    cp -r /tmp/skills-temp/plugins/skill-codex/skills/codex ~/.claude/skills/codex && \
    rm -rf /tmp/skills-temp
  3. 3User prompt
    Use codex to analyze this repository and suggest improvements for my claude code skill.
  4. 4Run a command like
    codex exec -m gpt-5.3-codex-spark \
      --config model_reasoning_effort="high" \
      --sandbox read-only \
      --full-auto \
      --skip-git-repo-check \
      "Analyze this Claude Code skill repository comprehensively..." 2>/dev/null

README

Note: If you want a more autonomous setup for agentic workflows, check out klaudworks/ralph-meets-rex.

Codex Integration for Claude Code

skillcodex

Purpose

Enable Claude Code to invoke the Codex CLI (codex exec and session resumes) for automated code analysis, refactoring, and editing workflows.

Prerequisites

  • codex CLI installed and available on PATH.
  • Codex configured with valid credentials and settings.
  • Confirm the installation by running codex --version; resolve any errors before using the skill.

Installation

This repository is structured as a Claude Code Plugin with a marketplace. You can install it as a plugin (recommended) or extract it as a standalone skill.

Option 1: Plugin Installation (Recommended)

Install via Claude Code's plugin system for automatic updates:

/plugin marketplace add skills-directory/skill-codex
/plugin install skill-codex@skill-codex

Option 2: Standalone Skill Installation

Extract the skill folder manually:

git clone --depth 1 git@github.com:skills-directory/skill-codex.git /tmp/skills-temp && \
mkdir -p ~/.claude/skills && \
cp -r /tmp/skills-temp/plugins/skill-codex/skills/codex ~/.claude/skills/codex && \
rm -rf /tmp/skills-temp

Usage

Important: Thinking Tokens

By default, this skill suppresses thinking tokens (stderr output) using 2>/dev/null to avoid bloating Claude Code's context window. If you want to see the thinking tokens for debugging or insight into Codex's reasoning process, explicitly ask Claude to show them.

Example Workflow

User prompt:

Use codex to analyze this repository and suggest improvements for my claude code skill.

Claude Code response: Claude will activate the Codex skill and:

  1. Ask which model to use (gpt-5.5, gpt-5.4, gpt-5.4-mini, gpt-5.3-codex-spark, or gpt-5.3-codex) unless already specified in your prompt.
  2. Ask which reasoning effort level (low, medium, or high) unless already specified in your prompt.
  3. Select appropriate sandbox mode (defaults to read-only for analysis)
  4. Run a command like:
codex exec -m gpt-5.3-codex-spark \
  --config model_reasoning_effort="high" \
  --sandbox read-only \
  --full-auto \
  --skip-git-repo-check \
  "Analyze this Claude Code skill repository comprehensively..." 2>/dev/null

Result: Claude will summarize the Codex analysis output, highlighting key suggestions and asking if you'd like to continue with follow-up actions.

Detailed Instructions

See plugins/skill-codex/skills/codex/SKILL.md for complete operational instructions, CLI options, and workflow guidance.

Files in the repo

Repository payload5 top-level entries
  • .claude-plugin
  • plugins
  • LICENSE
  • openpackage.yml
  • README.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More skills

obra/
superpowers

An agentic skills framework & software development methodology that works.

285k
1 add

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

117k
1 add
Vincentwei1021/
anything2explainer

Topic in, narrated explainer video out. A Claude Code / Codex skill that turns any topic into a black-canvas motion-graphics explainer video with TTS voiceover, subtitles and a chapter progress bar. Chinese or English; every frame drawn in code with Remotion.

666

Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)

71k