plugin-creator

Scaffold Codex plugin directories with manifests and marketplace entries.

Updated Aug 4, 2026
One-click install
npx skills add https://github.com/sjc786526-coder/RONDO --skill plugin-creator-sjc786526-coder
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plugin-creator
Source: https://github.com/sjc786526-coder/RONDO/tree/main/multidev/codex-rs/skills/src/assets/samples/plugin-creator
Command: npx skills add https://github.com/sjc786526-coder/RONDO --skill plugin-creator-sjc786526-coder

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Creating a Codex plugin by hand requires knowing the exact .codex-plugin/plugin.json schema, marketplace entry shape, and reinstall flow, and small mistakes cause ingestion or validation failures. This Skill generates a valid plugin scaffold and marketplace entry with correct defaults, then validates the result before handoff. ## Core Features & Use Cases - Plugin Scaffolding: Generates a normalized plugin directory with a validation-ready plugin.json, plus optional skills/, hooks/, scripts/, assets/, .mcp.json, and .app.json companions. - Marketplace Management: Creates or updates personal (~/.agents/plugins/marketplace.json) or repo/team marketplace entries with correct policy, category, and source path fields. - Update & Validation Flow: Rewrites plugin versions with a Codex cachebuster suffix for local iteration and validates manifests against the ingestion contract, rejecting [TODO: ...] placeholders. - Use Case: Ask the agent to create a new personal plugin named "my-tools" with skills and marketplace registration; it scaffolds the folder, seeds the marketplace entry, validates the manifest, and returns Codex app View/Share deeplinks. ## Quick Start Ask the agent to create a new Codex plugin named my-plugin with a marketplace entry and validate it before handing it back.

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 marketplace entry?▼

Run scripts/create_basic_plugin.py with the plugin name and --with-marketplace flag. It scaffolds the plugin folder under ~/plugins, writes a valid .codex-plugin/plugin.json, and appends an entry to ~/.agents/plugins/marketplace.json with default AVAILABLE and ON_INSTALL policies.

How to update a local Codex plugin during development?▼

Run scripts/update_plugin_cachebuster.py on the plugin path to rewrite the version with a +codex.<timestamp> suffix, then reinstall with codex plugin add <plugin-name>@<marketplace-name>. Start a new thread afterward so Codex picks up the updated skills and tools.

What fields are required in a Codex plugin.json manifest?▼

The manifest requires non-empty name, strict semver version, description, author.name, and an interface object with displayName, shortDescription, longDescription, developerName, category, capabilities, and defaultPrompt. Unsupported fields like hooks are rejected by validation.

When should I use a repo/team marketplace instead of the personal one?▼

Use a repo/team marketplace only when the user explicitly requests that destination, passing both --path and --marketplace-path. Non-default marketplaces are not discovered implicitly, so they must be installed with codex plugin marketplace add before reinstalling.

Why does plugin validation fail on my generated manifest?▼

Validation fails when the manifest contains [TODO: ...] placeholders, non-semver versions, unknown fields, non-https URLs, or asset paths pointing outside the plugin archive. Run scripts/validate_plugin.py on the plugin path to list every specific error.