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

•

開発者ツール

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

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.

主な機能

01YAML frontmatter support for structured setting and state extraction

02Built-in guidance for Git-ignoring and securing local state files

03Standardized .local.md file pattern for per-project configuration

04Bash parsing patterns for integrating settings into plugin hooks

05Markdown body integration for prompts, context, and documentation

06144 GitHub stars

ユースケース

01Storing agent-specific state and task assignments across development sessions

02Enabling or disabling specific plugin hooks without manual configuration edits

03Defining validation levels or processing modes for project-specific workflows

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tzachbon/smart-ralph Plugin Settings

For use in Claude.ai and ChatGPT

Download Skill