Codex skills are a way to extend the Codex CLI, reusable capabilities that let the agent handle specific kinds of work more reliably. If you've seen Claude Code's skills and plugins, the idea is similar: instead of re-explaining a workflow every time, you package it as a skill the agent can draw on. This guide covers what they are and how to get the most from them.
What Codex skills are
A skill bundles a capability or workflow so the Codex CLI can apply it consistently. Rather than prompting from scratch each time, you give the agent a reusable building block, for a particular task type, convention, or integration, and it leans on that when relevant.
The core idea
| Aspect | Detail |
|---|---|
| Reusable capabilities | Package a workflow once, reuse it across tasks. |
| More reliable behavior | The agent handles specific task types more consistently. |
| Less repeated prompting | You don't re-explain the same process every session. |
| Extends the CLI | Adds to what Codex can do beyond its defaults. |
Getting the most from Codex skills
Practical tips
| Tip | Detail |
|---|---|
| Start with your repeats | Build skills for the workflows you do most often. |
| Keep them focused | Narrow, well-defined skills are more reliable than catch-all ones. |
| Pair with the right model | A skill is only as good as the model running it, model choice still matters. |
| Check the official docs | Mechanism and syntax come from OpenAI's Codex documentation. |
Skills extend behavior, what about models and cost?
Skills make Codex better at tasks, but they don't change which model runs or what you pay. Those are separate levers, the quality of the underlying model and your billing. If you want to run Codex-style workflows against cheaper or different models, that's a routing question.
What that looks like with Wuwei
| Benefit | Detail |
|---|---|
| Many models, one endpoint | Run Codex-style workflows against Claude, GPT, Grok, Gemini, Kimi, DeepSeek and more. |
| Lower cost | Route routine work to cheaper models while skills handle the workflow. |
| Pay-as-you-go | One account, billed for what you run, no per-provider subscriptions. |
| No proxy setup | Natively supports OpenAI-compatible endpoints, nothing to configure. |
FAQ
What are Codex skills?
Codex skills are reusable capabilities that extend what the Codex CLI can do, letting the agent handle specific task types more reliably without re-prompting from scratch each time.
How are Codex skills different from codex plugins?
Skills are capabilities the agent gains; plugins typically package and distribute features. The exact relationship depends on OpenAI's implementation, check the official Codex docs.
Do Codex skills change which model I use?
No. Skills extend behavior but don't change your model or billing. To run Codex-style work against other models, use a router like Wuwei.
How do I create a Codex skill?
Define it following OpenAI's Codex documentation, focusing on a narrow, repeatable workflow. Keep skills focused for the most reliable results.