Awesome-omni-skill codex
Use when the user asks to run Codex CLI (codex exec, codex resume) or references OpenAI Codex for code analysis, refactoring, or automated editing
install
source · Clone the upstream repo
git clone https://github.com/diegosouzapw/awesome-omni-skill
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data-ai/codex" ~/.claude/skills/diegosouzapw-awesome-omni-skill-codex-e15564 && rm -rf "$T"
manifest:
skills/data-ai/codex/SKILL.mdsource content
Codex Skill Guide
This skill enables the use of Codex CLI for code analysis, refactoring, and automated editing tasks.
When to Use This Skill
Use this skill when the user:
- Asks to run Codex CLI commands (
,codex exec
)codex resume - References OpenAI Codex for code analysis
- Needs automated code refactoring
- Wants AI-powered code editing
Running a Task
- Ask the user (via
) which model to run (AskUserQuestion
orgpt-5.2-codex
) AND which reasoning effort to use (gpt-5.2
,xhigh
,high
, ormedium
) in a single prompt with two questions.low - Select the sandbox mode required for the task; default to
unless edits or network access are necessary.--sandbox read-only - Assemble the command with the appropriate options:
-m, --model <MODEL>--config model_reasoning_effort="<xhigh|high|medium|low>"--sandbox <read-only|workspace-write|danger-full-access>--full-auto-C, --cd <DIR>--skip-git-repo-check
- Always use --skip-git-repo-check.
- When continuing a previous session:
- Use
via stdincodex exec --skip-git-repo-check resume --last - Don't use any configuration flags unless explicitly requested by the user (e.g., if they specify the model or reasoning effort when requesting to resume)
- Resume syntax:
echo "your prompt here" | codex exec --skip-git-repo-check resume --last 2>/dev/null - All flags must be inserted between
andexecresume
- Use
- IMPORTANT: By default, append
to all2>/dev/null
commands to suppress thinking tokens (stderr). Only show stderr if the user explicitly requests to see thinking tokens or if debugging is needed.codex exec - Run the command, capture stdout/stderr (filtered as appropriate), and summarize the outcome for the user.
- After Codex completes, inform the user: "You can resume this Codex session at any time by saying 'codex resume' or asking me to continue with additional analysis or changes."
Quick Reference
| Use case | Sandbox mode | Key flags |
|---|---|---|
| Read-only review or analysis | | |
| Apply local edits | | |
| Permit network or broad access | | |
| Resume recent session | Inherited from original | `echo "prompt" \ |
| Run from another directory | Match task needs | plus other flags |
Following Up
- After every
command, immediately usecodex
to confirm next steps, collect clarifications, or decide whether to resume withAskUserQuestion
.codex exec resume --last - When resuming, pipe the new prompt via stdin:
. The resumed session automatically uses the same model, reasoning effort, and sandbox mode from the original session.echo "new prompt" | codex exec resume --last 2>/dev/null - Restate the chosen model, reasoning effort, and sandbox mode when proposing follow-up actions.
Error Handling
- Stop and report failures whenever
or acodex --version
command exits non-zero; request direction before retrying.codex exec - Before you use high-impact flags (
,--full-auto
,--sandbox danger-full-access
) ask the user for permission using AskUserQuestion unless it was already given.--skip-git-repo-check - When output includes warnings or partial results, summarize them and ask how to adjust using
.AskUserQuestion
Examples
Read-only Analysis
codex exec --skip-git-repo-check \ -m gpt-5.2-codex \ --config model_reasoning_effort="high" \ --sandbox read-only \ "Analyze the code structure and identify potential improvements" \ 2>/dev/null
Apply Edits
codex exec --skip-git-repo-check \ -m gpt-5.2 \ --config model_reasoning_effort="medium" \ --sandbox workspace-write \ --full-auto \ "Refactor the authentication module to use async/await" \ 2>/dev/null
Resume Session
echo "Now add error handling to the refactored code" | \ codex exec --skip-git-repo-check resume --last 2>/dev/null
Notes
- Thinking tokens are suppressed by default using
2>/dev/null - Always use
to avoid repository validation issues--skip-git-repo-check - The
flag allows Codex to make changes without confirmation--full-auto - Resume sessions inherit settings from the original session