How do I parse the configuration values in a bash script?

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

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

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

Do changes to these settings take effect immediately?

No, Claude Code typically requires a restart (exiting and re-entering the CLI) for hooks and commands to recognize changes made to .local.md files.

Where should plugin settings files be stored?

Settings should be stored in the .claude/ directory at the project root using the filename format plugin-name.local.md.

Plugin Settings Pattern

Name: Plugin Settings Pattern
Author: arlenagreer

byarlenagreer

0•

开发者工具

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

This skill establishes a robust architectural pattern for storing user-configurable settings and state within Claude Code plugins. By utilizing .local.md files in the .claude directory, developers can implement per-project customization without polluting the global environment or committing sensitive data to version control. It provides the necessary logic for parsing YAML frontmatter and markdown content via hooks, commands, and agents, ensuring plugin behavior remains flexible, persistent, and user-driven across different development environments.

主要功能

01YAML frontmatter parsing for structured configuration and metadata

02Per-project isolation via the .claude directory convention

030 GitHub stars

04Markdown body support for dynamic prompts and additional context

05Bash integration patterns for reading settings within hooks and commands

06Persistent state management for complex multi-agent coordination

使用场景

01Storing persistent agent state and task assignments for multi-step automation

02Implementing project-specific validation rules or security policies via local settings

03Creating configurable hooks that users can toggle without editing core JSON files

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add arlenagreer/claude_configuration_docs plugin-settings

For use in Claude.ai and ChatGPT

Download Skill