Plugin
Claude Code plugin lifecycle management: create, install, update, cache, troubleshoot.
Topics
| Topic | Description | Guide |
|---|---|---|
| cache | Cleanup only — clean old plugin cache versions and temp directories. NOT for "cache miss" or load errors — use troubleshoot instead | cache.md |
| clustering | Score skill-to-skill affinity (coupling / shared external dep / hook-ownership gate) and recommend plugin bundle membership. Feeds into create |
clustering.md |
| create | Plugin authoring guide (structure, plugin.json, components) | create.md |
| dev-reflect | Reflect a local dev source repo's plugin/skill changes into the registered marketplace clone for local testing before commit/push (helper: scripts/dev-reflect.sh) |
dev-reflect.md |
| hud | OMC HUD statusline configuration: omcHud elements, omcLabel toggle, wrapper sed fallback, version compatibility | hud.md |
| marketplace | Clone, list, and update marketplace repositories | marketplace.md |
| troubleshoot | All plugin errors — cache miss, load errors, /reload-plugins errors, /doctor failures, installation failures, cache sync, HUD diagnostics |
troubleshoot.md |
Routing rule (HARD STOP)
| User says | Topic |
|---|---|
| "cache miss", "cache error", "load error", "reload errors", "plugin not loading", "plugin not installed" | troubleshoot (NOT cache) |
| "cache cleanup", "old versions", "disk space", "remove temp_git_*" | cache |
cache.md only owns deletion of stale versions. Any diagnostic of "why isn't this plugin working" — including the literal phrase "cache miss" — routes to troubleshoot.md.
Paths
Marketplaces: ~/.claude/plugins/marketplaces/
Cache: ~/.claude/plugins/cache/<marketplace>/<plugin>/<version>/