plugin-creator

Scaffold Codex plugin directories with plugin.json manifests and marketplace.json entries.

1|Updated Jul 6, 2015
One-click install
npx skills add https://github.com/ksolomon/dotfiles --skill plugin-creator-ksolomon
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plugin-creator
Source: https://github.com/ksolomon/dotfiles/tree/main/AI/.codex/skills/.system/plugin-creator
Command: npx skills add https://github.com/ksolomon/dotfiles --skill plugin-creator-ksolomon

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Creating a new Codex plugin requires a specific directory structure, a correctly shaped .codex-plugin/plugin.json manifest, and optionally a marketplace entry with valid policy fields. Doing this by hand is error-prone and repetitive. ## Core Features & Use Cases - Plugin Scaffolding: Generates a normalized plugin folder with a complete placeholder plugin.json including the full interface section. - Optional Structure: Adds skills/, hooks/, scripts/, assets/, .mcp.json, and .app.json on demand via CLI flags. - Marketplace Management: Creates or updates .agents/plugins/marketplace.json entries with required policy.installation, policy.authentication, and category fields, supporting both repo-local and home-local plugins. - Use Case: You want to publish a new local plugin called "My Reports". Run the scaffold script to get plugins/my-reports/.codex-plugin/plugin.json with placeholders, then add --with-marketplace to register it in the marketplace ordering. ## Quick Start Ask the assistant to scaffold a new Codex plugin named my-plugin with a marketplace entry using the plugin-creator skill.

Frequently Asked Questions about plugin-creator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new Codex plugin directory?▼

Run the create_basic_plugin.py script with a plugin name to generate a folder containing .codex-plugin/plugin.json filled with placeholder values. The name is normalized to lowercase hyphen-case and must be 64 characters or fewer.

How to add a plugin to the Codex marketplace.json file?▼

Pass the --with-marketplace flag when scaffolding. The script creates or updates .agents/plugins/marketplace.json at the repo root, appending an entry with policy.installation, policy.authentication, and category fields.

Can I create a home-local plugin instead of a repo-local one?▼

Yes. Use --path ~/plugins and --marketplace-path ~/.agents/plugins/marketplace.json with --with-marketplace. The same relative ./plugins/<plugin-name> path convention applies to home-rooted marketplaces.

What optional folders can the plugin scaffold generate?▼

The script supports --with-skills, --with-hooks, --with-scripts, --with-assets, --with-mcp, and --with-apps flags. These create the corresponding directories or stub .mcp.json and .app.json files inside the plugin root.

Why does plugin creation fail when the marketplace entry already exists?▼

The script raises a FileExistsError if a marketplace entry with the same plugin name exists, to prevent accidental overwrites. Pass --force only when intentionally replacing the existing entry.