Should these configuration files be committed to Git?

No. These files use the .local.md extension and should be added to your .gitignore to ensure environment-specific settings stay local to the user.

Where are these settings files located?

Settings files are stored in the project root directory at .claude/plugin-name.local.md.

Do I need to restart Claude Code after updating settings?

Yes, because hooks are loaded at the start of a session, you must restart Claude Code for changes in the settings file to take effect.

How do I parse YAML fields in a Bash script?

The skill provides patterns using sed and grep to extract frontmatter content between the '---' markers and isolate individual key-value pairs.

Plugin Settings Pattern

Name: Plugin Settings Pattern
Author: kgadek

bykgadek

0•

Developer Tools

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

This skill establishes a standardized architectural pattern for storing user-configurable settings and state within a project's .claude/ directory. By leveraging .local.md files with YAML frontmatter, developers can create plugins that adapt their behavior—such as toggling features, setting validation levels, or tracking agent state—on a per-project basis without modifying core plugin code. The skill provides detailed implementation guides for reading and writing these settings through Bash hooks, commands, and agents, ensuring that plugin behavior remains flexible and context-aware while maintaining clean git histories.

Key Features

01Integration patterns for Agent-driven configuration and multi-step task tracking

02Security best practices for user-input sanitization and path validation

03Standardized .claude/*.local.md file structure with YAML frontmatter

040 GitHub stars

05Robust Bash parsing techniques for YAML and Markdown content in hooks

06Per-project plugin state management that bypasses git versioning

Use Cases

01Configuring project-specific feature flags and validation strictness levels

02Defining custom prompts and context to be injected into specific plugin commands

03Managing persistent state for multi-agent coordination within a workspace

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kgadek/kgadek-claude-plugin plugin-settings

For use in Claude.ai and ChatGPT

Download Skill