Should settings files be committed to Git?

No, settings files are intended to be local to the environment. You should add `.claude/*.local.md` to your .gitignore file.

How do I read these settings in a bash script?

You can use standard CLI tools like sed to extract the frontmatter between triple dashes and grep to parse specific key-value pairs.

Where should I store plugin settings files?

Plugin settings should be stored in the project root directory at `.claude/plugin-name.local.md`.

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

Yes, for hooks to recognize new settings, you must restart the Claude Code session as hooks cannot be hot-swapped.

Can agents use these settings files?

Yes, agents can be instructed to read the .local.md file to adapt their behavior based on the configuration and instructions found in the markdown body.

Plugin Settings Pattern

Name: Plugin Settings Pattern
Author: astrosteveo

byastrosteveo

0•

Developer Tools

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

The Plugin Settings skill provides a standardized architectural pattern for managing local plugin configurations and persistent state within the Claude Code environment. By utilizing the `.claude/plugin-name.local.md` format, it enables developers to create configurable plugins that store structured data in YAML frontmatter and contextual prompts in markdown. This approach is essential for developers building complex workflows that require per-project overrides, stateful agent coordination, or user-defined processing rules that remain outside of version control.

Key Features

01Pre-built Bash patterns for parsing settings in hooks and commands

02Git-safe local storage pattern that prevents leaking private configs

030 GitHub stars

04Standardized .claude/*.local.md file structure for easy discovery

05YAML frontmatter integration for structured data and configuration

06Markdown body support for storing dynamic prompts and context

Use Cases

01Managing state and task handoffs in multi-agent swarms

02Defining project-specific validation rules and processing modes

03Controlling plugin hook activation on a per-project basis

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add astrosteveo/claude-code-plugins plugin-settings

For use in Claude.ai and ChatGPT

Download Skill