plugin-settings

npx skills add anthropics/claude-plugins-official --skill plugin-settings --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# 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 ```markdown --- enabled: true setting1: value1 setting2: value2 numeric_setting: 42 list_setting: ["item1", "item2"] --- # Additional Context This markdown body can contain: - Task descriptions - Additional instructions - Prompts to feed back to Claude - Documentation or notes ``` ### Example: Plugin State File **.claude/my-plugin.local.md:** ```markdown --- enabled: true strict_mode: false max_retries: 3 notification_level: info coordinator_session: team-leader --- # Plugin Configuration This plugin is configured for standard validation mode. Cont

set -euo pipefail
Define state file path
Quick exit if file doesn't exist
if [[ ! -f "$STATE_FILE" ]]; then
exit 0  # Plugin not configured, skip
fi
Parse YAML frontmatter (between --- markers)
Extract individual fields
Check if enabled
if [[ "$ENABLED" != "true" ]]; then