Add to this marketplace
This repo is a plugin marketplace. .claude-plugin/marketplace.json lists the plugins;
each plugin lives in plugins/<plugin>/ and holds its skills in
plugins/<plugin>/skills/<skill>/SKILL.md.
Adding a skill to an existing plugin needs no registration — skills/ is
auto-discovered. Adding a whole new plugin needs a manifest and a marketplace entry.
A new skill in an existing plugin
Pick a kebab-case name, e.g.
release-notes.Create the directory and
SKILL.md:plugins/<plugin>/skills/release-notes/ ├── SKILL.md ├── references/ # optional, read on demand └── scripts/ # optional helper scriptsWrite the frontmatter. Both fields are required:
--- name: release-notes description: Generate release notes from merged PRs. Use when the user asks for a changelog or release notes for a version or tag. ---namemust match the directory name and be kebab-case. Always set it explicitly — without it the skill falls back to the install directory name, which changes on update.descriptionis what Claude matches against to decide whether to load the skill. Say both what it does and when to use it, with the concrete words a user would type. A vague description means the skill never fires.
Write the body as instructions to the agent, not documentation for a human. Keep
SKILL.mdshort and push detail intoreferences/files the agent reads only when it needs them.
A new plugin
plugins/<name>/.claude-plugin/plugin.json—nameis the only required field;displayName,description,version,author,licenseandkeywordsare worth setting. Copyplugins/ticket-review/.claude-plugin/plugin.json.- Put skills in
plugins/<name>/skills/, slash commands inplugins/<name>/commands/. Both are auto-discovered. - Add an entry to the
pluginsarray in.claude-plugin/marketplace.jsonwithnameandsource: "./plugins/<name>". - Add a row to the plugin table in the root
README.md.
Before committing
claude plugin validate . # marketplace manifest
claude plugin validate ./plugins/<name> # plugin manifest
Then install from the local clone and confirm the skill actually triggers on a realistic prompt:
/plugin marketplace add /path/to/agent-skills
/plugin install <name>@agent-skills
Run /plugin marketplace update after each change.