How can I parse these settings in a bash hook?

You can use sed to extract the content between the --- markers and then use grep and sed to isolate specific YAML key-value pairs.

Why use .local.md instead of a standard JSON file for settings?

The .local.md format allows for a flexible combination of structured YAML data for logic and rich Markdown content for prompts, instructions, or documentation.

Do I need to restart Claude Code after changing a plugin setting?

Yes, because hooks cannot be hot-swapped within a session, you must exit and restart Claude Code for changes to .local.md files to take effect in hooks.

Should I commit .local.md files to my Git repository?

No, these files are intended for user-specific or environment-specific configuration and should always be added to your .gitignore to prevent accidental commits.

Where are plugin settings stored in Claude Code?

Settings are stored in the .claude/ directory of your project root using the naming convention plugin-name.local.md.

Plugin Settings Pattern

Name: Plugin Settings Pattern
Author: astrosteveo

byastrosteveo

•

Developer Tools

Standardizes per-project configuration for Claude Code plugins using YAML frontmatter and markdown state files.

This skill provides a robust pattern for managing plugin-specific settings and state within Claude Code projects by utilizing the .claude/plugin-name.local.md file structure. Developers can implement user-configurable behaviors, maintain agent state across sessions, and create configuration-driven hooks without cluttering version control. It offers standardized methods for parsing YAML frontmatter in bash and integrating these settings into commands and agents, ensuring that plugin behavior remains flexible, project-specific, and easily manageable by the end user.

Key Features

01Guidelines for configuration-driven agent and command behavior

02Bash implementation patterns for reading settings in hooks

03Markdown body integration for prompts and context

04YAML frontmatter support for structured configuration

051 GitHub stars

06Standardized .claude/plugin-name.local.md file pattern

Use Cases

01Managing state and task assignments for multi-agent coordination swarms

02Storing project-specific validation rules, security policies, and environment flags

03Enabling or disabling specific plugin hooks on a per-project basis

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add astrosteveo/marketplace plugin-settings

For use in Claude.ai and ChatGPT

Download Skill