claude-code-plugin-reference

# Claude Code Plugin Reference (night-market edition) This is the domain pack for how Claude Code plugin machinery works in this repository. It covers manifests, skills, commands, agents, hooks, and the marketplace registry, with the local conventions layered on top. Every contract below was checked against a shipped plugin (mostly `plugins/imbue`, `plugins/abstract`, and `plugins/herald`) on 2026-07-02 at repo v1.9.15. When another night-market skill says "see the plugin reference for what a hook payload is," this is the file it means. ## Vocabulary Each term is defined once here and used without redefinition below. | Term | Meaning in this repo | |------|----------------------| | Plugin | A directory under `plugins/` shipping skills, commands, agents, and hooks, with its own tests, Makefile, and pyproject.toml. Independently deployable (ADR-0001). | | Skill | A directory `skills/<name>/` containing `SKILL.md`. Loaded by the model on demand, invoked as `Skill(plugin:name)`. | | Module | A file under a skill's `modules/` subdirectory. Loaded only when the hub `SKILL.md` routes to it (progressive loading). | | Command | A markdown file under `commands/`. Surfaces as a slash command the user types. Repo docs refer to the namespaced form, e.g. `/sanctum:sync-capabilities`. | | Agent | A markdown file under `agents/` defining a dispatchable subagent: frontmatter plus a system-prompt body. | | Hook | An executable script Claude Code runs on a lifecycle event, registered in the...