Do settings updates take effect immediately?

No, because Claude Code loads plugin hooks and configurations at startup, you must restart your Claude Code session for changes to be recognized.

How do I parse these settings in a Bash hook?

The skill provides regex-based patterns using 'sed' and 'awk' to extract data between the YAML frontmatter markers (---) directly within your scripts.

Where should I store plugin configuration files?

Configuration files should be placed in the project root under the `.claude/` directory, following the naming convention `plugin-name.local.md`.

Should these configuration files be committed to Git?

No. The `.local.md` naming convention is designed to keep settings local to your environment. You should add `.claude/*.local.md` to your project's .gitignore file.

Plugin Configuration Pattern

Name: Plugin Configuration Pattern
Author: BbgnsurfTech

byBbgnsurfTech

•

개발자 도구

Manages project-specific plugin settings and state using a standardized YAML frontmatter and Markdown file pattern.

The Plugin Configuration Pattern skill provides a robust architectural framework for Claude Code plugins to handle user-configurable settings and persistent state. By utilizing the `.claude/plugin-name.local.md` file format, developers can implement project-specific behaviors that remain local and excluded from version control. This skill includes implementation guides and code snippets for reading configuration via Bash hooks, commands, and agents, allowing for dynamic plugin behavior based on structured YAML data and Markdown-based context.

주요 기능

01YAML frontmatter for structured configuration keys

023 GitHub stars

03Environment-specific state and project configuration

04Standardized .claude/*.local.md file structure

05Bash-native parsing for hooks and automation

06Markdown body support for prompts and instructions

사용 사례

01Storing agent state and task history within a project directory

02Toggling specific plugin hooks without modifying global configurations

03Setting project-specific validation rules for security and linting plugins

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bbgnsurftech/claude-skills-collection plugin-settings

For use in Claude.ai and ChatGPT

Download Skill