plugin-creator

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

1|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/p-potvin/vaultwares-pipelines --skill plugin-creator-p-potvin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plugin-creator
Source: https://github.com/p-potvin/vaultwares-pipelines/tree/main/.github/agents/codex/.system/plugin-creator
Command: npx skills add https://github.com/p-potvin/vaultwares-pipelines --skill plugin-creator-p-potvin

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill removes manual scaffolding and manifest creation for Codex plugins by automating plugin folder creation, manifest population, and optional marketplace entry updates to reduce errors and speed development.

Core Features & Use Cases

  • Full Manifest Scaffolding: Generates a .codex-plugin/plugin.json populated with the complete schema shape and placeholder values ready for human editing.
  • Marketplace Integration: Creates or updates .agents/plugins/marketplace.json entries with required policy fields and preserves existing interface.displayName.
  • Optional Companion Structure: Can add skills/, hooks/, scripts/, assets/, .mcp.json, and .app.json alongside the plugin folder and supports repo-local or home-local installation workflows.
  • Use Case: Quickly create a normalized local plugin for testing in Codex and append it to the repository marketplace so it appears in the UI with correct ordering and policy metadata.

Quick Start

Run the scaffold script from the repository root to create a new plugin by invoking the create_basic_plugin.py script with the desired plugin name and any optional flags.

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 and generate the manifest automatically?

Scaffold a Codex plugin by running the creation script from the repository root to instantly generate a normalized plugin folder and a fully populated plugin.json manifest with complete schema placeholders.

What is the best way to add a new plugin to the Codex marketplace.json?

Add a new plugin to the Codex marketplace.json by using the scaffolding script to automatically create or update the entry while preserving existing interface.displayName and applying required policy.installation metadata.

Does Codex plugin scaffolding support both repo-local and home-local installations?

Yes, Codex plugin scaffolding supports both repo-local and home-local installation workflows, allowing you to configure the target directory and generate optional companion folders like skills/, hooks/, and scripts/.

How do I safely overwrite an existing Codex plugin directory without losing data?

Safely overwrite an existing Codex plugin directory by passing the --force flag to the scaffolding script, which explicitly controls overwrite behavior to prevent accidental data loss during manifest updates.

What fields are required when creating a plugin.json manifest for Codex?

A valid plugin.json manifest for Codex requires normalized plugin names, full schema placeholders, and explicit policy.installation and policy.authentication fields to ensure correct UI display and secure deployment.