Files
holocron/plugins/kyberforge/skills/marketplace-author/README.md
Defame1297 528ba05b37 fix(marketplace-author): require version bump on every catalog mutation
## Why
The skill had no instruction to bump the catalog version after ADD, REMOVE, or UPDATE operations. Clients cache the marketplace catalog and use the version field to detect changes — without a bump, the new state is invisible until a forced refresh.

## Implementation Notes
Added a Gotcha explaining the rule and semver convention (ADD/REMOVE → minor, UPDATE → patch). Added a dedicated "Bump catalog version" step to each mutating flow. Updated README to match.

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-28 15:30:47 +00:00

1.7 KiB

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. Bumps the catalog version on every mutation (minor for ADD/REMOVE, patch for UPDATE). 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/

Marketplace files managed

File Read by
.claude-plugin/marketplace.json Claude Code
.github/plugin/marketplace.json Copilot CLI