How do I parse YAML settings in a Bash hook?

The pattern uses sed or awk to extract content between the triple-dash markers, allowing you to isolate and grep specific configuration fields.

Do I need to restart Claude Code after changing settings?

Yes, because hooks and plugin configurations are typically loaded at the start of a session, a restart is required for changes to take effect.

Why use .local.md files for plugin settings?

It provides a human-readable format that supports both structured data (YAML) and rich text (Markdown) while remaining easily excluded from version control via .gitignore.

Is it safe to store credentials in these settings files?

While the files are local, you should always ensure .claude/*.local.md is added to your .gitignore to prevent sensitive data from being committed to a repository.

Plugin Settings Pattern

Name: Plugin Settings Pattern
Author: jawhnycooke

byjawhnycooke

开发者工具

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

关于

This skill provides a robust architectural pattern for Claude Code plugins to handle user-configurable settings and persistent state. By utilizing the .claude/plugin-name.local.md file format, it allows developers to separate logic from configuration, enabling per-project behaviors for hooks, commands, and agents. The pattern includes proven methods for parsing YAML frontmatter directly from Bash scripts and instructions for managing local-only state that stays out of version control, ensuring a secure and flexible development workflow.

主要功能

Standardized .claude/plugin-name.local.md file structure
Markdown body support for dynamic prompts and context
Secure, local-only storage patterns that respect .gitignore
YAML frontmatter for structured configuration data
0 GitHub stars
Integrated Bash parsing techniques for hooks and commands

使用场景

Maintaining state for autonomous agents across multiple Claude sessions
Enabling or disabling specific plugin hooks on a per-project basis
Defining project-specific validation rules and processing modes

关于

主要功能

Standardized .claude/plugin-name.local.md file structure
Markdown body support for dynamic prompts and context
Secure, local-only storage patterns that respect .gitignore
YAML frontmatter for structured configuration data
0 GitHub stars
Integrated Bash parsing techniques for hooks and commands

使用场景

Maintaining state for autonomous agents across multiple Claude sessions
Enabling or disabling specific plugin hooks on a per-project basis
Defining project-specific validation rules and processing modes