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

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

Can settings files contain instructions for Claude?

Absolutely. The Markdown body following the YAML frontmatter is ideal for storing task descriptions, prompts, or additional context that your plugin can read and feed back to Claude.

Do I need to restart Claude Code after updating a settings file?

Yes, because hooks and plugin configurations are loaded at startup, you must restart Claude Code for changes in .local.md files to take effect.

Where are plugin settings files stored?

Settings should be stored in the project root under the .claude/ directory, specifically using the naming convention plugin-name.local.md.

How do I parse YAML settings in a bash hook?

The recommended pattern uses sed to extract content between the triple-dash delimiters and grep/awk to isolate specific configuration values.

Plugin Settings & State Management

Name: Plugin Settings & State Management
Author: anthropics

byanthropics

•

291

开发者工具

Implements a standardized pattern for managing project-specific plugin configurations and persistent state using YAML frontmatter.

关于

This skill provides a comprehensive framework for Claude Code plugin developers to handle user-configurable settings and state management. By adopting the .claude/plugin-name.local.md pattern, developers can store structured configuration in YAML frontmatter and detailed context in Markdown bodies. The skill offers proven implementation patterns for reading these files via Bash hooks, commands, and agents, ensuring that plugin behavior can be customized per-project without committing sensitive or local-only data to version control.

主要功能

Secure lifecycle management via .gitignore best practices
Standardized .claude/plugin-name.local.md file structure
Markdown body support for prompts and human-readable context
Bash-ready parsing techniques for hooks and CLI commands
YAML frontmatter for machine-readable configuration and state
291 GitHub stars

使用场景

Coordinating state and task numbers across multi-agent swarms
Defining project-specific validation levels and processing modes
Enabling or disabling specific plugin hooks on a per-project basis

关于

主要功能

Secure lifecycle management via .gitignore best practices
Standardized .claude/plugin-name.local.md file structure
Markdown body support for prompts and human-readable context
Bash-ready parsing techniques for hooks and CLI commands
YAML frontmatter for machine-readable configuration and state
291 GitHub stars

使用场景

Coordinating state and task numbers across multi-agent swarms
Defining project-specific validation levels and processing modes
Enabling or disabling specific plugin hooks on a per-project basis