Claude Code Plugin¶
The claude-code-plugin/ subdirectory ships prompt-decorators as an installable Claude Code plugin. Users prepend a ::Name(params) or +++Name(params) line to any prompt and the plugin's UserPromptSubmit hook expands it into precise instructions using the prompt-decorators engine before the model sees the prompt.
This page is a pointer. The canonical reference for the plugin — full subcommand list, config schema, security posture, vendoring, sync policy — lives next to the plugin source at
claude-code-plugin/README.md. This page summarises and links; that README is the source of truth. The authoring guide (how to write a new decorator) and the usage guide (when to suggest one) live as installable skills underclaude-code-plugin/skills/.
What the plugin does (short version)¶
- Inline syntax:
::Nameor+++Nameat the start of a prompt line. Mid-line occurrences are ignored (so Rust/C++ paths likestd::collections::HashMap;don't false-trigger). /decorateslash command: browse, preview, search, toggle always-on list, control auto-decorate mode.- Auto-decorate (opt-in): a two-pass selector picks 0-3 decorators per prompt. Can be one-shot, stateful, or off.
- User registry override: personal decorators under
$HOME/.config/prompt-decorators/extensions/survive vendor re-syncs. - Self-contained: the engine and decorator registry are vendored into the plugin directory, so no
pip installis required by end users.
Install¶
From Claude Code:
Further reading¶
- Plugin reference:
claude-code-plugin/README.md— inline syntax,/decoratesubcommands, auto-decorate internals, configuration, security, full how-it-works. - Usage guidance skill:
skills/prompt-decorators-usage/SKILL.md— when and how to suggest decorators for a given prompt. - Authoring skill:
skills/authoring-decorators/SKILL.md— how to write a new decorator (naming, schema, testing). - Vendoring and sync policy:
claude-code-plugin/VENDORING.md. - Marketplace entry: the companion synapti-marketplace repo points at this directory via a
git-subdirsource, so plugin updates flow through automatically.