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

•

Developer Tools

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.

Key Features

01Cross-context support for bash hooks, CLI commands, and AI agents

02Ready-to-use parsing techniques for shell scripts and automated tools

03Standardized YAML frontmatter for structured plugin configuration

04Markdown-based state files for storing rich agent context and prompts

051 GitHub stars

06Secure-by-design local file pattern compatible with .gitignore

Use Cases

01Managing state and task coordination for multi-agent swarms

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

03Storing project-specific validation rules and security policies

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add pur3v4d3r/pur3-pkb-codebase plugin-settings

For use in Claude.ai and ChatGPT

Download Skill