Plugin Settings
Establishes a standard pattern for creating user-configurable, per-project settings for plugins using local markdown files.
Key features
- Documents common patterns for toggling hooks and managing agent state.
- Utilizes YAML frontmatter for structured configuration and a markdown body for context.
- Outlines best practices for file naming, gitignore management, and providing default values.
- Defines a file pattern (`.claude/plugin-name.local.md`) for per-project settings.
- Provides shell script examples for parsing settings within hooks and commands.
Use cases
- Making a plugin's behavior configurable on a per-project basis.
- Allowing users to enable, disable, or customize plugin features without editing source code.
- Storing and managing state for complex tools, like coordinating multi-agent systems.
FAQ
When should I use this skill?
Use this skill when you want to make a plugin's behavior customizable for each project, temporarily enable or disable hooks without restarting Claude, or store state for complex agent workflows.
How does this skill improve my workflow?
It allows you to create flexible, reusable plugins that adapt to different project needs without code changes. This avoids hardcoding values and enables easy management of features like validation rules, API keys, or agent behavior directly within a project.
What does the Plugin Settings skill do?
It establishes a standard pattern for creating user-configurable, per-project settings for Claude Code plugins. It uses local `.claude/plugin-name.local.md` files with YAML frontmatter to store configuration that can be read by hooks, commands, and agents.
What capabilities does it provide?
This skill provides a defined file structure (`.local.md` with YAML), shell script examples for parsing settings, best practices for gitignore management and default values, and documented patterns for managing agent state and dynamically controlling hooks.
Related skills
Claude Plugin Configuration Manager
Standardizes per-project plugin settings and state management using YAML frontmatter and Markdown files within the .claude directory.
Developer Tools142,11812 ptsClaude Code Agent Architect
Guides developers through the creation, configuration, and optimization of autonomous subagents for Claude Code plugins.
Developer Tools142,11812 ptsHook Development
Create event-driven automation scripts (hooks) to validate operations, enforce policies, and customize Claude Code workflows.
Developer Tools46,24612 pts