Agent skill · software engineering · openai
plugin-creator
Create and scaffold plugin directories for Codex with a required `.codex-plugin/plugin.json`, optional plugin folders/files, and baseline placeholders you can edit before publishing or testing. Use when Codex needs to create a new local plugin, add optional plugin structure, or generate or update repo-root `.agents/plugins/marketplace.json` entries for plugin ordering and availability metadata.
Why this skill is useful
Adds a script that automates the creation and scaffolding of plugin directories and metadata for Codex, which the AI wouldn't reliably generate on its own.
What it needs
Requires python3 installed locally. About 3k tokens when loaded. Last updated 2026-07-14. 24,594 stars on the source repository.
What this skill does
Plugin Creator Quick Start 1. Run the scaffold script: 2. Open <plugin-path>/.codex-plugin/plugin.json and replace [TODO: ...] placeholders. 3. Generate or update the repo marketplace entry when the plugin should appear in Codex UI ordering: For a home-local plugin, treat <home> as the root and use: 4. Generate/adjust optional companion folders as needed: <parent-plugin-directory> is the directory where the plugin folder <plugin-name> will be created (for example ~/code/plugins). What this skill creates If the user has not made the plugin location explicit, ask whether they want a repo-local plugin or a home-local plugin before generating marketplace entries. Creates plugin root at /<parent-plugin-directory>/<plugin-name>/. Always creates /<parent-plugin-directory>/<plugin-name>/.codex-plugin/plugin.json. Fills the manifest with the full schema shape, placeholder values, and the complete interface section. Creates or updates <repo-root>/.agents/plugins/marketplace.json when --with-marketplace is set. If the marketplace file does not exist yet, seed top-level name plus interface.displayName placeholders before adding the first plugin entry. <plugin-name> is normalized using skill-creator naming rules: My Plugin → my-plugin My--Plugin → my-plugin underscores, spaces, and punctuation are converted to - result is lower-case hyphen-delimited with consecutive hyphens collapsed Supports optional creation of: skills/ hooks/ scripts/ assets/ .mcp.json .app.json Marketplace workflow marketplace.json always lives at <repo-root>/.agents/plugins/marketplace.json. For a home-local plugin, use the same convention with <home> as the root: ~/.agents/plugins/marketplace.json plus ./plugins/<plugin-name>. Marketplace root metadata supports top-level name plus optional interface.displayName. Treat plugin order in plugins[] as render order in Codex. Append new entries unless a user explicitly asks to reorder the list. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills openai/plugin-creator--4c2049