# Claude Code Plugin Scaffold

> Teaches the agent the exact shape of a Claude Code plugin: the plugin.json manifest, a marketplace.json entry for distribution, and how commands/ and skills/ bundle together so `/plugin install` or a local marketplace add picks it up without errors.

Canonical: https://www.agentickit.co/skills/claude-code-plugin-scaffold
Last updated: 2026-11-18

## Key practices
- Write plugin.json with name, version (semver), and description before anything else exists
- Bundle one slash command under commands/ and one skill under skills/ so the plugin does something on first install
- Register the plugin in marketplace.json with a unique name — collisions with reserved or existing marketplace names fail silently on install
- Test locally by pointing Claude Code at the plugin directory before publishing to a marketplace repo
- Bump plugin.json's version on every change; stale versions are the most common reason a published update doesn't show up

## Related
- [devops-engineer](https://www.agentickit.co/agents/devops-engineer)
- [tech-lead](https://www.agentickit.co/agents/tech-lead)
- [/ci-pipeline](https://www.agentickit.co/commands/ci-pipeline)
- [/release](https://www.agentickit.co/commands/release)
