Skip to content
Codex DesignBETA

Skill Creator for Codex.

Skill Creator is the skill Codex uses to write other skills. It walks through a fixed process, scaffolds the folder with a script, and keeps the result short so it doesn’t waste context. It comes built into Codex.

Updated November 12, 2026 · 3 min read

At a glance

Skill nameskill-creator
Comes withCodex itself, as a system skill
InstallBuilt into Codex (a system skill); nothing to install
Codex uses itWhen you ask it to create a new skill or update an existing one
Sourceopenai/skills on GitHub

What it does

The skill follows six steps in order: understand the skill through concrete examples, plan its scripts, references and assets, initialize it, edit it, validate it, then iterate after real use.

It ships three Python scripts that do the mechanical parts:

  • init_skill.py: creates the skill folder with a SKILL.md template, optional scripts/, references/ and assets/ folders, and an agents/openai.yaml file.
  • generate_openai_yaml.py: writes the display_name, short_description and default_prompt that Codex shows in its skill list.
  • quick_validate.py: checks the frontmatter format, required fields and naming rules.

It also sets writing rules. Frontmatter holds only name and description, and the description carries all the “when to use” information, because Codex reads nothing else before deciding. The body stays under 500 lines, with detail moved into reference files one level deep. Names are lowercase hyphen-case, under 64 characters. No README or changelog files inside the skill.

When to use it

Use it when you keep giving Codex the same instructions, or when a task needs a script or schema every time. It turns that into a skill Codex picks up on its own, with a description written to trigger at the right moments.

Try it

Turn a repeated task into a skill
Use the skill-creator skill. Create a skill for this repo that adds a new page in all six locales: it should copy the English MDX, add the route to the registry, and run the type check. Ask me for examples before you write it.

Does it work in Claude Code?

Mostly. The SKILL.md and its scripts are plain files, so you can copy the folder from GitHub into ~/.claude/skills. The agents/openai.yaml file it generates is Codex UI metadata, which Claude Code ignores, and the text refers to Codex throughout.

Keep reading

An independent plugin for Codex. Not affiliated with or endorsed by OpenAI.