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

開発者ツール

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.

主な機能

YAML frontmatter parsing for structured configuration and metadata
Per-project isolation via the .claude directory convention
0 GitHub stars
Markdown body support for dynamic prompts and additional context
Bash integration patterns for reading settings within hooks and commands
Persistent state management for complex multi-agent coordination

ユースケース

Storing persistent agent state and task assignments for multi-step automation
Implementing project-specific validation rules or security policies via local settings
Creating configurable hooks that users can toggle without editing core JSON files

概要

主な機能

YAML frontmatter parsing for structured configuration and metadata
Per-project isolation via the .claude directory convention
0 GitHub stars
Markdown body support for dynamic prompts and additional context
Bash integration patterns for reading settings within hooks and commands
Persistent state management for complex multi-agent coordination

ユースケース

Storing persistent agent state and task assignments for multi-step automation
Implementing project-specific validation rules or security policies via local settings
Creating configurable hooks that users can toggle without editing core JSON files