plugin-settings
Installation
SKILL.md
Plugin Settings Pattern
Per-project plugin configuration using .claude/plugin-name.local.md files with YAML frontmatter for structured settings and markdown body for additional context.
When to Use This Skill
| Use plugin settings when... | Use alternatives when... |
|---|---|
| Plugin needs per-project configuration | Settings are global (use ~/.claude/settings.json) |
| Hooks need runtime enable/disable control | Hook behavior is always-on |
| Agent state persists between sessions | State is ephemeral within a session |
| Users customize plugin behavior per-project | Plugin has no configurable behavior |
| Configuration includes prose/prompts alongside structured data | All config is purely structured (use .json) |