What is the benefit of using the .local.md pattern?

The .local.md pattern allows for project-specific settings that are not committed to Git. This enables developers to have unique configurations for different environments without affecting the core plugin logic or other team members.

Where should these configuration files be located?

Settings files should be placed in the '.claude/' directory at the root of your project, following the naming convention 'plugin-name.local.md'.

How can I read these settings within a Bash hook?

You can extract the YAML frontmatter using tools like 'sed' to isolate the content between triple-dash markers, then use 'grep' and 'sed' to parse individual configuration keys into variables.

Do settings changes apply immediately in Claude Code?

No, changes to plugin settings files generally require a restart of the Claude Code session for hooks and agents to load and apply the new configuration.

Plugin Configuration Manager

Name: Plugin Configuration Manager
Author: michelabboud

bymichelabboud

•

Developer Tools

Standardizes project-specific plugin settings and state management using a hybrid YAML frontmatter and Markdown pattern.

The Plugin Configuration Manager skill provides a standardized framework for Claude Code plugins to store and retrieve user-configurable settings and internal state. By utilizing the `.claude/plugin-name.local.md` file pattern, it enables developers to implement flexible, per-project behaviors for hooks, commands, and agents. This pattern leverages YAML for structured data and Markdown for rich context, ensuring that plugin configurations remain organized, local to the project, and easily accessible via Bash scripts or AI instructions.

Key Features

01Structured configuration using YAML frontmatter parsing

021 GitHub stars

03Project-specific state management for multi-agent workflows

04Standardized .claude/*.local.md file naming convention

05Bash-compatible parsing techniques for plugin hooks

06Markdown body support for rich prompts and context

Use Cases

01Persisting agent state and task history across Claude Code sessions

02Toggling specific plugin features or hooks on a per-project basis

03Defining custom validation levels and security policies for development tools

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add michelabboud/claude-code plugin-settings

For use in Claude.ai and ChatGPT

Download Skill