Where are the plugin settings files stored?

Settings are stored in the .claude/ directory of your project root using the naming convention plugin-name.local.md.

What is the benefit of using Markdown for settings?

Using Markdown allows you to store both machine-readable YAML configuration and human-readable prompts or instructions that can be fed directly back into Claude.

Do I need to restart Claude Code after changing settings?

Yes, because hooks and configurations are typically loaded at session initialization, a restart is required for new settings to take effect.

Should I commit these settings files to Git?

No. The pattern uses the .local.md extension specifically so these files can be added to your .gitignore, keeping project-specific configurations private.

Can I use these settings in automated bash hooks?

Absolutely. This skill includes documented patterns for using sed, grep, and awk to parse YAML values directly within shell scripts.

Plugin Settings Pattern

Name: Plugin Settings Pattern
Author: pur3v4d3r

bypur3v4d3r

•

开发者工具

Implements a standardized configuration pattern for Claude Code plugins using YAML frontmatter and markdown state files.

关于

The Plugin Settings skill provides a robust architectural pattern for managing project-specific configuration and state within Claude Code plugins. By utilizing the .claude/plugin-name.local.md file structure, developers can separate structured configuration (via YAML frontmatter) from rich contextual instructions (via Markdown content). This enables dynamic plugin behavior, persistent agent state tracking, and per-project customization while ensuring sensitive or environment-specific data remains git-ignored and local to the project environment.

主要功能

Cross-context support for bash hooks, CLI commands, and AI agents
Ready-to-use parsing techniques for shell scripts and automated tools
Standardized YAML frontmatter for structured plugin configuration
Markdown-based state files for storing rich agent context and prompts
1 GitHub stars
Secure-by-design local file pattern compatible with .gitignore

使用场景

Managing state and task coordination for multi-agent swarms
Enabling or disabling specific plugin hooks on a per-project basis
Storing project-specific validation rules and security policies

关于

主要功能

Cross-context support for bash hooks, CLI commands, and AI agents
Ready-to-use parsing techniques for shell scripts and automated tools
Standardized YAML frontmatter for structured plugin configuration
Markdown-based state files for storing rich agent context and prompts
1 GitHub stars
Secure-by-design local file pattern compatible with .gitignore

使用场景

Managing state and task coordination for multi-agent swarms
Enabling or disabling specific plugin hooks on a per-project basis
Storing project-specific validation rules and security policies