Skip to content
Skill

plugin-creator

by openai

AI Summary

1. Run the scaffold script: 2. Open and replace placeholders. 3. Generate or update the repo marketplace entry when the plugin should appear in Codex UI ordering:

Install

Copy this and paste it into Claude Code, Cursor, or any AI assistant:

I want to install the "plugin-creator" skill in my project.

Please run this command in my terminal:
# Install skill into your project (5 files)
mkdir -p .claude/skills/plugin-creator && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/plugin-creator/SKILL.md "https://raw.githubusercontent.com/openai/skills/main/skills/.system/plugin-creator/SKILL.md" && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/plugin-creator/LICENSE.txt "https://raw.githubusercontent.com/openai/skills/main/skills/.system/plugin-creator/LICENSE.txt" && mkdir -p .claude/skills/plugin-creator/agents && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/plugin-creator/agents/openai.yaml "https://raw.githubusercontent.com/openai/skills/main/skills/.system/plugin-creator/agents/openai.yaml" && mkdir -p .claude/skills/plugin-creator/references && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/plugin-creator/references/plugin-json-spec.md "https://raw.githubusercontent.com/openai/skills/main/skills/.system/plugin-creator/references/plugin-json-spec.md" && mkdir -p .claude/skills/plugin-creator/scripts && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/plugin-creator/scripts/create_basic_plugin.py "https://raw.githubusercontent.com/openai/skills/main/skills/.system/plugin-creator/scripts/create_basic_plugin.py"

Then restart Claude Code (or reload the window in Cursor) so the skill is picked up.

Description

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.

Quick Start

• Run the scaffold script: `bash # Plugin names are normalized to lower-case hyphen-case and must be <= 64 chars. # The generated folder and plugin.json name are always the same.

By default creates in <repo_root>/plugins/<plugin-name>.

python3 .agents/skills/plugin-creator/scripts/create_basic_plugin.py <plugin-name> ` • Open <plugin-path>/.codex-plugin/plugin.json and replace [TODO: ...] placeholders. • Generate or update the repo marketplace entry when the plugin should appear in Codex UI ordering: `bash

marketplace.json always lives at <repo-root>/.agents/plugins/marketplace.json

python3 .agents/skills/plugin-creator/scripts/create_basic_plugin.py my-plugin --with-marketplace ` For a home-local plugin, treat <home> as the root and use: `bash python3 .agents/skills/plugin-creator/scripts/create_basic_plugin.py my-plugin \ --path ~/plugins \ --marketplace-path ~/.agents/plugins/marketplace.json \ --with-marketplace ` • Generate/adjust optional companion folders as needed: `bash python3 .agents/skills/plugin-creator/scripts/create_basic_plugin.py my-plugin --path <parent-plugin-directory> \ --with-skills --with-hooks --with-scripts --with-assets --with-mcp --with-apps --with-marketplace ` <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

Discussion

0/2000
Loading comments...

Health Signals

MaintenanceCommitted Today
Active
Adoption1K+ stars on GitHub
17.2k ★ · Popular
DocsREADME + description
Well-documented

GitHub Signals

Stars17.2k
Forks1.1k
Issues198
UpdatedToday
View on GitHub
No License

My Fox Den

Community Rating

Sign in to rate this booster

Works With

Claude Code