plugin-creator

Scaffold a local Codex plugin project with plugin.json and optional directories.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/wmasfoe/notch-pet --skill plugin-creator-wmasfoe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plugin-creator
Source: https://github.com/wmasfoe/notch-pet/tree/main/.codex/skills/.system/plugin-creator
Command: npx skills add https://github.com/wmasfoe/notch-pet --skill plugin-creator-wmasfoe

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Create and scaffold Codex plugin directories and a standard placeholder manifest to bootstrap local plugins and marketplace entries.

Core Features & Use Cases

  • Generates a repo-local or home-local plugin skeleton including <plugin-name>/.codex-plugin/plugin.json and optional folders (skills, scripts, assets, hooks).
  • Creates or updates a marketplace entry at a given marketplace path, preserving existing marketplace interface when updating.
  • Keeps placeholder values for human editing and supports force overwrite when needed.

Quick Start

Run the scaffold script for a given plugin name to generate a local plugin folder with a placeholder plugin.json.

Frequently Asked Questions about plugin-creator

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

FAQPage Schema
How do I scaffold a Codex plugin with a plugin.json manifest?

To scaffold a Codex plugin, this generator creates the plugin root directory and a .codex-plugin/plugin.json manifest with safe placeholder defaults. It also sets up optional folders like scripts and assets.

Can I generate a marketplace entry for a local Codex plugin?

Yes, you can generate a placeholder marketplace entry for a local Codex plugin. The scaffolder creates or updates the marketplace.json file while preserving existing interface metadata during the update.

How do I set up a repo-local versus a home-local Codex plugin?

You can set up both repo-local and home-local Codex plugins using the scaffolder. It normalizes the plugin name to kebab-case and generates the appropriate directory structure for either location.

Does the Codex plugin generator support overwriting existing plugin manifests?

Yes, the Codex plugin generator supports force overwrite for existing manifests. By default it writes placeholder values for human editing, but you can force overwrite when needed.

What directories are included when scaffolding a Codex plugin project?

Scaffolding a Codex plugin project includes the plugin root, .codex-plugin/plugin.json, and optional directories such as skills, scripts, assets, and hooks depending on your needs.

Why does my Codex plugin name need to be in kebab-case?

Codex plugin names need to be in kebab-case because the scaffolder validates and normalizes the name to this format. This ensures safe defaults and consistent naming for the plugin.json manifest.