Can I parse these settings using standard Bash scripts?

Yes, this pattern is designed specifically to be parsed using common utilities like sed and awk, making it easy to integrate configuration into Bash-based hooks.

Do I need to restart Claude Code after changing settings?

Yes, because hooks cannot be hot-swapped within an active session, a restart is required for the new settings to be recognized by the plugin.

Where should I store plugin settings in my project?

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

Should I commit these settings files to Git?

No, these files use the .local.md suffix and should be added to your .gitignore to ensure that user-specific configurations are not committed to the repository.

Plugin Settings Pattern

Name: Plugin Settings Pattern
Author: zach-source

byzach-source

0•

开发者工具

Standardizes per-project configuration for Claude Code plugins using YAML frontmatter and Markdown files.

This skill provides a robust implementation pattern for creating user-configurable Claude Code plugins. By utilizing the .claude/plugin-name.local.md file format, developers can store project-specific settings, agent states, and persistent prompts that are easily parsed by Bash scripts, commands, and agents. It includes standardized templates, best practices for Git management, and efficient parsing techniques to enable configuration-driven behavior without complex external dependencies.

主要功能

01YAML frontmatter for structured data storage

02Optimized Bash parsing techniques for hooks and scripts

03Markdown body support for prompts and extended context

04Standardized .claude/*.local.md configuration pattern

05Built-in project-level state management for autonomous agents

060 GitHub stars

使用场景

01Enabling or disabling specific plugin hooks on a per-project basis

02Storing environment-specific toggles and preferences safely outside of version control

03Managing state and task progress for complex multi-agent workflows

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add zach-source/claude-plugins plugin-settings

For use in Claude.ai and ChatGPT

Download Skill