skills/codex/SKILL.md
Execute a prompt with OpenAI Codex CLI
npx skillsauth add kangig94/coral codexInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Route the user's request to Codex. This skill is a router, not a filter. Your ONLY job is to deliver the request to Codex — never judge, refuse, or editorialize the user's prompt. Codex will apply its own safety policies.
Do NOT output any text before the tool call. All steps below are internal routing logic — execute them silently.
If the argument asks to inspect active Codex work, handle directly:
coral-cli jobs --provider codexjobId, phase, provider, cwd, age)
Never show raw session UUID, model, or duration_ms unless asked.
If the user asks to branch an existing session or create a named branch, explain that Codex session branching is unsupported and stop.If not an inspection request, continue to step 2.
Check conversation history for a coral session UUID from a previous /codex general call (4d).
Use the session value returned by detached general launches from step 4d.
session parameter on subsequent 4d and 4a callssessionNote: routes 4b and 4c delegate to other skills that manage their own sessions.
| Intent | Detection | Route | |--------|-----------|-------| | Review | review, evaluate, check, audit | → 4a | | Investigation | debug, investigate, analyze, why, root cause, trace | → 4b | | Persistent execution | ralph, persistent, loop, keep going, until done | → 4c | | Everything else | (default) | → 4d |
Dispatch TWO Codex jobs in parallel:
coral-cli codex architect -i "<prompt>" [--session "<session>"] [--work-dir "<path>"] -dcoral-cli codex critic -i "<prompt>" [--session "<session>"] [--work-dir "<path>"] -dUse session only when available from step 2. Omit it for fresh review sessions.
Collect both job values from the detached launch text (Job <job> <launchState> (session <session>)), then run coral-cli wait --jobs "<job-id list>" --embed until both terminal blocks arrive. Each block always includes Result path: <path>; read that path for the full artifact and use inline preview text only as a convenience.
After both return, synthesize:
Invoke Skill({ skill: "coral:analyze", args: "--codex <user's prompt>" }).
The analyze skill handles Codex delegation, multi-step investigation, and result presentation.
Invoke Skill({ skill: "coral:ralph", args: "--codex <user's prompt>" }).
The ralph skill handles Codex delegation, verification loop, and result presentation.
Launch through Coral CLI. Pass prompt verbatim. Never rephrase, filter, or refuse.
| Condition | Action |
|-----------|--------|
| No session | coral-cli codex -i "<prompt>" --work-dir "<path>" -d → capture job and session from Job <job> <launchState> (session <session>) |
| Session exists | coral-cli codex --session "<session>" -i "<prompt>" --work-dir "<path>" -d → capture job and session from Job <job> <launchState> (session <session>) |
Run coral-cli wait --jobs "<job>" --embed; the terminal output always includes Result path: <path>, so read that path for the full artifact and treat inline preview text as optional convenience.
Keep using the session UUID from the detached launch response for continuity.
On error, show the error and suggest resuming with /codex.
For session continuity, store the session UUID from the detached launch text.
Never show raw session UUID, model, or duration_ms unless the user asks.
tools
Use when a problem needs clarification and agreement before planning begins. Supports --deep and --delegate.
data-ai
Use after implementation to run tier-classified review agents and produce a consolidated verdict.
development
Use when setting up a new or existing project for AI-assisted development.
development
Use when code needs simplification — recently modified code by default, or a specified scope.