How do I read settings in a Bash hook script?

You can use sed to extract the YAML frontmatter between the triple-dash markers and then use grep or awk to parse individual fields into variables.

Where are the plugin setting files stored?

Settings are stored in the .claude/ directory of your project root using the plugin-name.local.md naming convention.

Do I need to restart Claude Code after changing settings?

Yes, because hooks cannot be hot-swapped within a session, a restart of Claude Code is required for the new configuration to take effect.

Should I commit these settings files to Git?

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

Can agents interact with these settings?

Yes, agents can be instructed to check for these files and parse the content to adapt their behavior based on project-specific rules or state.

Plugin Configuration Settings

Name: Plugin Configuration Settings
Author: tzachbon

bytzachbon

•

144

Herramientas para Desarrolladores

Implements a standardized pattern for project-specific Claude Code plugin settings using YAML frontmatter and Markdown files.

Acerca de

This skill establishes a robust framework for managing user-configurable settings and state within Claude Code plugins via the .claude/plugin-name.local.md pattern. By combining structured YAML frontmatter for data and Markdown for rich context, it allows developers to create highly customizable plugins that adapt their behavior on a per-project basis. It provides detailed implementation patterns for Bash hooks, custom commands, and agents, ensuring that plugin state is easily readable, writable, and maintainable while remaining safely outside of version control.

Características Principales

YAML frontmatter support for structured setting and state extraction
Built-in guidance for Git-ignoring and securing local state files
Standardized .local.md file pattern for per-project configuration
Bash parsing patterns for integrating settings into plugin hooks
Markdown body integration for prompts, context, and documentation
144 GitHub stars

Casos de Uso

Storing agent-specific state and task assignments across development sessions
Enabling or disabling specific plugin hooks without manual configuration edits
Defining validation levels or processing modes for project-specific workflows

Acerca de

Características Principales

YAML frontmatter support for structured setting and state extraction
Built-in guidance for Git-ignoring and securing local state files
Standardized .local.md file pattern for per-project configuration
Bash parsing patterns for integrating settings into plugin hooks
Markdown body integration for prompts, context, and documentation
144 GitHub stars

Casos de Uso

Storing agent-specific state and task assignments across development sessions
Enabling or disabling specific plugin hooks without manual configuration edits
Defining validation levels or processing modes for project-specific workflows