Codex Skills: How to Install, Create and Use Agent Skills in OpenAI Codex (2026)
Quick answer: Codex skills are folders with a
SKILL.mdfile that teach OpenAI's Codex a repeatable workflow, using the same open format as Claude skills.Install one with the built-in
$skill-installer, or create your own with$skill-creator.
OpenAI Codex, its coding agent, supports agent skills. A skill packages instructions, resources and optional scripts so Codex can follow a workflow reliably.
This guide explains how Codex skills work, how to install and create them, and how they relate to Claude skills.
Codex skills at a glance
| Question | Answer |
|---|---|
| What is a Codex skill? | A directory with a SKILL.md file, plus optional scripts and references |
| Required settings | name and description |
| Which format? | The open Agent Skills standard, the same one Claude uses |
| Where do they work? | The Codex CLI, the IDE extension and the Codex app |
| How are they loaded? | Name and description first, full instructions only when needed |
| How do you install one? | $skill-installer inside Codex, or a package tool such as npx skills |
| How do you create one? | $skill-creator, or write the file by hand |
How Codex skills work
Codex uses progressive disclosure, the same idea as Claude. It starts with each skill's name, description and file path, and loads the full SKILL.md only when it decides to use that skill.
That keeps a large collection of skills cheap. A skill you never use costs almost nothing.
By default, Codex uses a skill when your request matches its description. You can turn that off for a specific skill, so it only runs when you ask for it.
Codex skills vs Claude skills
They use the same format, so most skills move between the two.
| Codex | Claude | |
|---|---|---|
| Format | SKILL.md in the Agent Skills standard | SKILL.md in the Agent Skills standard |
| Required fields | name, description | name, description |
| Loading | Progressive disclosure | Progressive disclosure |
| Built-in helpers | $skill-installer, $skill-creator | Example skills, plus the files you add |
| Extra settings | An optional file for Codex-specific policy | Optional fields in Claude Code |
A skill written for one tool should usually work in the other, but test it, because tools differ in the scripts and settings they support. To learn the basics first, read what Claude skills are.
How to install Codex skills
There are three common routes.
1. Use the built-in installer
Inside a Codex session, name the skill you want. Codex installs it from OpenAI's catalogue.
$skill-installer gh-fix-ci
You can also point it at a skill's address in a GitHub repository.
2. Use a package tool
The open-source skills command installs skills from a GitHub repository and routes them to the right folder for each agent.
npx skills add vercel-labs/agent-skills -a codex
The -a codex option tells it to install into Codex's skills folder.
3. Copy the folder yourself
Place the skill folder in a skills directory that Codex reads, either for one repository or for your whole account. Folder locations have changed between versions, so check OpenAI's documentation for the current paths.
After installing, start a new Codex session so it picks up the skill.
The official OpenAI skills catalogue
OpenAI publishes a public skills repository. Skills fall into three groups.
| Group | What it holds | Examples |
|---|---|---|
| System | Built in, ready to use | Skill creator, plugin creator, OpenAI docs, image generation |
| Curated | Installed by name with $skill-installer | Fixing CI failures, building CLI tools, creating ChatGPT apps |
| Experimental | Installed by address | Early or niche skills, such as planning |
Browse the catalogue before you write your own, because one may already do the job.
How to create a Codex skill
You have two options.
Let Codex scaffold it. Run $skill-creator, describe the capability you want, and Codex builds the folder and file for you.
Write it yourself. The process is the same as for Claude, so follow our step-by-step guide on how to create Claude skills. The file has the same two required fields and the same structure.
If you want other developers to install your work, OpenAI suggests packaging a skill as a plugin.
How to turn a Codex skill off
You can disable a skill without deleting it. Add an entry for it in the config.toml file in your Codex folder.
[[skills.config]]
path = "/path/to/skill/SKILL.md"
enabled = false
To stop Codex from using a skill on its own, while keeping it available on request, use a Codex-specific policy file inside the skill folder.
Skills from our directory that fit Codex
Our directory lists skills in the open SKILL.md format, which Codex reads. These are good places to start, though you should test each one in Codex.
- Systematic Debugging: find the root cause before fixing a bug.
- Test Driven Development: write the test first.
- Requesting Code Review: review at the right moments.
- GitHub Actions: write and fix CI workflows.
Browse more in the Coding category and the best Claude Code skills. Review anything you install first, using our safety checklist.
Tips for using skills in Codex
- Start small: install two or three skills and see how Codex uses them.
- Match your wording to the description: Codex picks skills by their description.
- Keep project skills in the repository: the whole team gets the same workflow.
- Update them: re-install a skill when its source changes.
Frequently asked questions
Does OpenAI Codex support skills?
Yes. Skills work in the Codex CLI, the IDE extension and the Codex app. They build on the open Agent Skills standard.
Are Codex skills the same as Claude skills?
They use the same SKILL.md format and the same two required fields. Most skills move between the tools, but test each one, because supported scripts and settings can differ.
How do I install a skill in Codex?
Use $skill-installer followed by a skill name, or install a package with the skills command. You can also copy a skill folder into a folder Codex reads.
How do I create a skill in Codex?
Run $skill-creator and describe the capability, or write the SKILL.md file yourself. It needs a name and a description.
How do I disable a Codex skill?
Add an entry for it in your Codex config.toml file with enabled = false. That turns it off without deleting the folder.
Related guides
- 25 Claude skills examples you can copy: Real skill descriptions and six patterns to reuse.
- Claude Code subagents vs skills vs hooks vs plugins: What each extension point does and when to use it.
Methodology and disclosure
This guide draws on OpenAI's published Codex documentation and independent write-ups, checked in November 2026. Folder locations and commands change with each release, so confirm details in OpenAI's documentation.
We have no affiliation with OpenAI, and this article contains no affiliate links.