Agent skill · software engineering · davila7
Plugin Settings
This skill should be used when the user asks about "plugin settings", "store plugin configuration", "user-configurable plugin", ".local.md files", "plugin state files", "read YAML frontmatter", "per-project plugin settings", or wants to make plugin behavior configurable. Documents the .claude/plugin-name.local.md pattern for storing plugin-specific configuration with YAML frontmatter and markdown content.
Why this skill is useful
Documents a specific pattern for storing plugin settings using YAML frontmatter and markdown, which the AI wouldn't reliably generate on its own.
What it needs
About 6k tokens when loaded. Last updated 2026-08-06. 30,138 stars on the source repository.
What this skill does
Plugin Settings Pattern for Claude Code Plugins Overview Plugins can store user-configurable settings and state in .claude/plugin-name.local.md files within the project directory. This pattern uses YAML frontmatter for structured configuration and markdown content for prompts or additional context. Key characteristics: File location: .claude/plugin-name.local.md in project root Structure: YAML frontmatter + markdown body Purpose: Per-project plugin configuration and state Usage: Read from hooks, commands, and agents Lifecycle: User-managed (not in git, should be in .gitignore) File Structure Basic Template Example: Plugin State File .claude/my-plugin.local.md: Reading Settings Files From Hooks (Bash Scripts) Pattern: Check existence and parse frontmatter See examples/read-settings-hook.sh for complete working example. From Commands Commands can read settings files to customize behavior: From Agents Agents can reference settings in their instructions: Parsing Techniques Extract Frontmatter Read Individual Fields String fields: Boolean fields: Numeric fields: Read Markdown Body Extract content after second ---: Common Patterns Pattern 1: Temporarily Active Hooks Use settings file to control hook activation: Use case: Enable/disable hooks without editing hooks.json (requires restart). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills davila7/plugin-settings