Files

Defame1297 4d061bd199 feat(kyberforge): add plugin-author and marketplace-author skills

## 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

2026-06-28 10:45:03 +00:00

1.6 KiB

Raw Blame History

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

1.6 KiB Raw Blame History