create-plugin

Scaffolds new RedSkills repository plugins compliant with marketplace and structural contracts.

20|2|Updated May 16, 2026
One-click install
npx skills add https://github.com/reddb-io/red-skills --skill create-plugin-reddb-io
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-plugin
Source: https://github.com/reddb-io/red-skills/tree/main/plugins/internal/skills/maintainer/create-plugin
Command: npx skills add https://github.com/reddb-io/red-skills --skill create-plugin-reddb-io

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Creating a new plugin in the RedSkills repository requires many files and registry entries that must all satisfy marketplace, skill, README, CHANGES, and structural-smoke contracts; doing this by hand is error-prone and quickly drifts out of compliance. ## Core Features & Use Cases - Contract-first scaffolding: Generates plugin.json files for Claude and Codex, a seed SKILL.md, structural-smoke.sh, README.md, and CHANGES.md in one command. - Registry integration: Automatically appends entries to the Claude and agents marketplace JSON files and the root README. - Born-compliant seed skill: The generated SKILL.md follows the two-section body convention with a bold imperative lead and a concrete Use when trigger so it passes the frontmatter audit and body lint. - Use Case: A maintainer needs to add a new plugin called acme-tools; running the scaffolder produces every required file and registry entry, then prints the validation commands to confirm compliance. ## Quick Start Ask the agent to run the create-plugin scaffolder from the RedSkills repository root with your desired plugin name, then execute the printed validation commands.

Frequently Asked Questions about create-plugin

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

FAQPage Schema
How do I create a new plugin in the RedSkills repository?▼

Run the create-plugin.sh scaffolder from the repository root with your plugin name. It generates plugin.json manifests, a seed SKILL.md, structural-smoke.sh, README.md, and CHANGES.md, then appends entries to the marketplace JSON files and root README.

What files does the RedSkills plugin scaffolder generate?▼

It creates .claude-plugin/plugin.json, .codex-plugin/plugin.json, a seed skill SKILL.md under skills/core, scripts/structural-smoke.sh, README.md, and CHANGES.md. It also updates both marketplace.json registries and the root README.

Can I scaffold a plugin into a copied fixture or another checkout?▼

Yes, pass the --root flag with the target path before the plugin name. This lets you run the scaffolder against a fixture directory or a different checkout instead of the current repository root.

How do I validate a newly scaffolded RedSkills plugin?▼

Run the validation commands printed by the scaffolder after generation. They cover marketplace validation, the frontmatter audit, and the generated plugin's own structural smoke script, which together form the compliance contract.

Why does the generated seed SKILL.md use a specific body structure?▼

The seed follows the two-section convention with what-to-do and supporting-info sections, a bold imperative lead sentence, and a concrete Use when trigger in the description. This ensures it passes both the frontmatter audit and the report-only body lint.