plugin-creator

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

Updated Aug 19, 2026
One-click install
npx skills add https://github.com/jakubbartnik/honey-barrel-finale --skill plugin-creator-jakubbartnik
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plugin-creator
Source: https://github.com/jakubbartnik/honey-barrel-finale/tree/main/honey-barrel-finale/workspace/openclaw-config/agents/main/agent/codex-home/skills/.system/plugin-creator
Command: npx skills add https://github.com/jakubbartnik/honey-barrel-finale --skill plugin-creator-jakubbartnik

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 layout, a correctly shaped .codex-plugin/plugin.json manifest, and a properly formatted marketplace.json entry; doing this by hand is error-prone and easy to get wrong. ## 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 policy and category fields, supporting both repo-local and home-local plugins. - Use Case: You want to publish a new local plugin for Codex. Run the scaffold script with --with-marketplace to get the plugin skeleton and a valid marketplace entry, then fill in the [TODO: ...] placeholders. ## Quick Start Ask the agent to create a new plugin named my-plugin with marketplace registration using the plugin-creator scaffold script.

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 with a plugin.json manifest?▼

Run the create_basic_plugin.py script with your plugin name to generate a folder containing .codex-plugin/plugin.json with placeholder values. Then edit the [TODO: ...] fields in the manifest before publishing or testing.

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

Run the scaffold script with the --with-marketplace flag to create or update .agents/plugins/marketplace.json. Each entry includes the plugin name, local source path, installation and authentication policies, and a category.

What naming rules apply to Codex plugin names?▼

Plugin names are normalized to lowercase hyphen-case: spaces, underscores, and punctuation become hyphens, and consecutive hyphens are collapsed. Names must contain at least one letter or digit and be at most 64 characters.

Can I create a plugin outside the repository, in my home directory?▼

Yes, pass --path ~/plugins and --marketplace-path ~/.agents/plugins/marketplace.json with --with-marketplace. The marketplace entry still uses the relative path ./plugins/<plugin-name> resolved against the home root.

What happens if a marketplace entry for my plugin already exists?▼

The script raises an error and refuses to overwrite the existing entry unless you pass --force. Use --force only when intentionally replacing an entry for the same plugin name.