Agent skill · software engineering · aiskillstore
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 YAML frontmatter pattern for plugin configuration that the AI wouldn't reliably generate on its own.
What it needs
About 6k tokens when loaded. Last updated 2026-08-07. 405 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 aiskillstore/plugin-settings