$ skilldirectory
— zsh — registry.skilldirectory.dev
skill libraryblogguidesabout

home / blog / agent skills

Codex Skills: How to Install, Create and Use Agent Skills in OpenAI Codex (2026)

Quick answer: Codex skills are folders with a SKILL.md file 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

QuestionAnswer
What is a Codex skill?A directory with a SKILL.md file, plus optional scripts and references
Required settingsname 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.

CodexClaude
FormatSKILL.md in the Agent Skills standardSKILL.md in the Agent Skills standard
Required fieldsname, descriptionname, description
LoadingProgressive disclosureProgressive disclosure
Built-in helpers$skill-installer, $skill-creatorExample skills, plus the files you add
Extra settingsAn optional file for Codex-specific policyOptional 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.

GroupWhat it holdsExamples
SystemBuilt in, ready to useSkill creator, plugin creator, OpenAI docs, image generation
CuratedInstalled by name with $skill-installerFixing CI failures, building CLI tools, creating ChatGPT apps
ExperimentalInstalled by addressEarly 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.

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.

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.