Plugin#

Claude Code plugin lifecycle management: create, install, update, cache, troubleshoot.

Topics#

TopicDescriptionGuidecacheCleanup only — clean old plugin cache versions and temp directories. NOT for "cache miss" or load errors — use troubleshoot insteadcache.mdclusteringScore skill-to-skill affinity (coupling / shared external dep / hook-ownership gate) and recommend plugin bundle membership. Feeds into createclustering.mdcreatePlugin authoring guide (structure, plugin.json, components)create.mddev-reflectReflect 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.mdhudOMC HUD statusline configuration: omcHud elements, omcLabel toggle, wrapper sed fallback, version compatibilityhud.mdmarketplaceClone, list, and update marketplace repositoriesmarketplace.mdtroubleshootAll plugin errors — cache miss, load errors, /reload-plugins errors, /doctor failures, installation failures, cache sync, HUD diagnosticstroubleshoot.md

Routing rule (HARD STOP)#

User saysTopic"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#

text

Marketplaces: ~/.claude/plugins/marketplaces/
Cache:        ~/.claude/plugins/cache/<marketplace>/<plugin>/<version>/