What problem does it solve? Claude Code plugins often need user-configurable behavior and persistent state, but there is no built-in mechanism for per-project settings. This Skill documents the .claude/plugin-name.local.md pattern, letting plugin authors store structured YAML configuration and markdown prompts that hooks, commands, and agents can read at runtime. ## Core Features & Use Cases - Settings File Pattern: Defines the .claude/plugin-name.local.md convention with YAML frontmatter for structured config and a markdown body for prompts or task context. - Bash Parsing Techniques: Provides sed, grep, and awk recipes for extracting frontmatter fields and body content, plus atomic update patterns using temp files. - Real-World Examples: Includes working hook scripts, command templates, and case studies from the multi-agent-swarm and ralph-wiggum plugins. - Use Case: A plugin author building a validation hook can let users toggle strict mode, set file size limits, and enable logging by creating a .local.md file, without editing hooks.json or restarting their workflow logic. ## Quick Start Ask the AI to add user-configurable settings to your Claude Code plugin using the .claude/plugin-name.local.md pattern with YAML frontmatter.
