Plugin Creator for Codex.
Plugin Creator sets up a new Codex plugin: the .codex-plugin/plugin.json manifest, any optional folders you need, and an entry in a marketplace file so the plugin shows up in Codex. It comes built into Codex.
Updated November 12, 2026 · 3 min read
At a glance
| Skill name | plugin-creator |
| Comes with | Codex itself, as a system skill |
| Install | Built into Codex (a system skill); nothing to install |
| Codex uses it | When you ask it to create a local plugin, add plugin structure, or update a marketplace.json entry |
| Source | openai/skills on GitHub |
What it does
The skill runs one script, create_basic_plugin.py, with your plugin name. It normalizes the name to lowercase hyphen-case (My Plugin becomes my-plugin), up to 64 characters, and uses it for both the folder and the manifest.
What you get:
- Always:
<plugin-name>/.codex-plugin/plugin.json, with the full schema and[TODO: ...]placeholders for you to fill in. - Optional folders:
--with-skills,--with-hooks,--with-scripts,--with-assets,--with-mcp(a.mcp.json) and--with-apps(a.app.json). - Marketplace entry:
--with-marketplaceadds the plugin to.agents/plugins/marketplace.json, creating the file if needed.
New marketplace entries default to "installation": "AVAILABLE" and "authentication": "ON_INSTALL", and always include a category. Order in the plugins list is the order Codex shows them, so new entries go at the end. If you haven’t said where the plugin lives, Codex asks whether it should be repo-local or in your home folder (--path ~/plugins with a marketplace file at ~/.agents/plugins/marketplace.json).
When to use it
Use it when you want to bundle skills, hooks or an MCP server into something you can install or share, instead of writing the manifest by hand.
Try it
Use the plugin-creator skill. Create a repo-local plugin called design-review with a skills folder and an MCP config, and add it to the marketplace file so it shows up in Codex.
Does it work in Claude Code?
The script is plain Python and runs anywhere, so the folder can be copied into ~/.claude/skills. But what it builds is a Codex plugin: a .codex-plugin/plugin.json manifest and a Codex marketplace entry. Claude Code plugins use their own manifest, so the output won’t install there.