Defame1297
4d061bd199
## Why Plugin and marketplace management had no governed authoring path. Creating or updating a plugin required knowing the dual-manifest convention, version parity rules, and directory skeleton by memory — nothing enforced consistency or guided the process. `/plugin-author` closes that gap by owning the full plugin scaffold lifecycle: create, update, rename, and release. `/marketplace-author` handles the marketplace-facing side: register, deregister, and update plugin entries in `marketplace.json`. ADR-0016 codifies the version parity convention (identical `version` in both `plugin.json` and `.claude-plugin/plugin.json`) that `/plugin-author` now enforces. The two plugin.json files in this repo are backfilled to comply (keys also sorted to pass the pretty-format-json hook). CONTEXT.md gains glossary entries for "plugin scaffold" and "version parity" so future agents have shared vocabulary for these concepts. ## Implementation Notes `/plugin-author` ships a `scripts/new-plugin.sh` scaffold script that generates the directory skeleton and both manifests in one shot; the skill calls the script rather than generating files ad hoc so the scaffold is reviewable and repeatable. Version parity is an invariant, not a suggestion — the skill will fail loudly on create/update if the two versions would diverge. ADR: docs/adr/0016-plugin-version-parity.md
marketplace-author
Adds, removes, and updates plugin entries in the holocron marketplace manifest.
What it does
Manages entries in the plugins[] array of marketplace.json. Always updates both .claude-plugin/marketplace.json and .github/plugin/marketplace.json in the same edit pass — never one without the other. Routes automatically to add, remove, update, or create-from-scratch based on whether the files exist and whether the named plugin is already in the catalog. Runs claude plugin validate . after every mutating operation.
Before you start
Have ready: the plugin name (kebab-case), what you want to do (add/remove/update), and — for add — the source type and source value. If adding from an external repo, know the source type (local path, GitHub, git URL, or npm).
Usage
/marketplace-author
No manual script. This skill is purely agentic — it reads, edits, and writes the marketplace files directly using the Read/Edit/Write tools.
Files
| File | Purpose |
|---|---|
SKILL.md |
Skill instructions for agents |
references/manifest-fields.md |
Full field reference for top-level and per-entry marketplace.json fields, all four source type shapes with examples, and why both files must stay identical |
references/sources.md |
Research provenance — sources that informed this skill |
references/README.md |
Directory meta-documentation for references/ |
tests/README.md |
Notes on test coverage for this skill |
Marketplace files managed
| File | Read by |
|---|---|
.claude-plugin/marketplace.json |
Claude Code |
.github/plugin/marketplace.json |
Copilot CLI |