Do I need to restart Claude Code after changing settings?

Yes, current Claude Code hooks require a restart to recognize and load changes made to .local.md configuration files.

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

The .local.md format allows you to combine structured machine-readable data (YAML) with human-readable instructions or LLM prompts in the Markdown body.

Where are the plugin settings files stored?

Settings are stored in the .claude/ directory within your project root, typically following the naming convention plugin-name.local.md.

Should I commit these configuration files to Git?

No, these files are intended for project-specific local configuration and state. You should add .claude/*.local.md to your .gitignore file.

Can I use these settings in Bash hooks?

Absolutely. This pattern provides specific shell script examples for parsing YAML frontmatter using standard utilities like sed and grep.

Claude Plugin Configuration Pattern

Name: Claude Plugin Configuration Pattern
Author: rodolfolermacontreras

byrodolfolermacontreras

•

開発者ツール

Standardizes per-project plugin configuration and state management using YAML frontmatter and Markdown files.

This skill provides a standardized architectural pattern for storing user-configurable settings and persistent state within Claude Code plugins. By utilizing `.claude/plugin-name.local.md` files, developers can implement per-project behaviors, manage multi-agent coordination, and store custom prompts without polluting the codebase or git history. It includes specific implementation guides for hooks, commands, and agents, ensuring that plugin behavior is both flexible and easily manageable by the end-user while maintaining a clear separation between code and configuration.

主な機能

01Standardized .claude/*.local.md file structure for configuration

02YAML frontmatter parsing for structured, programmatic settings

03Markdown body support for dynamic prompts and additional context

041 GitHub stars

05Secure, git-ignored local state management for sensitive or local-only data

06Implementation patterns for Bash hooks, commands, and AI agents

ユースケース

01Toggling specific plugin hooks or features on a per-project basis without editing code

02Managing persistent state and task handoffs in complex multi-agent workflows

03Providing user-configurable thresholds, validation levels, and modes for custom tools

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add rodolfolermacontreras/microsoft-ai-learning plugin-settings

For use in Claude.ai and ChatGPT

主な機能

01Standardized .claude/*.local.md file structure for configuration

02YAML frontmatter parsing for structured, programmatic settings

03Markdown body support for dynamic prompts and additional context

041 GitHub stars

05Secure, git-ignored local state management for sensitive or local-only data

06Implementation patterns for Bash hooks, commands, and AI agents

ユースケース

01Toggling specific plugin hooks or features on a per-project basis without editing code

02Managing persistent state and task handoffs in complex multi-agent workflows

03Providing user-configurable thresholds, validation levels, and modes for custom tools

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add rodolfolermacontreras/microsoft-ai-learning plugin-settings

For use in Claude.ai and ChatGPT