Do I need to restart Claude Code after changing settings?

Yes, because hooks and plugin configurations are loaded at startup, you must restart your Claude Code session for changes to take effect.

What is the benefit of using Markdown for settings?

Using Markdown allows you to combine structured YAML data with human-readable instructions or prompts that can be fed directly back to the AI.

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.

Can I use these settings in Bash scripts?

Absolutely. This skill includes specific Bash patterns using sed and grep to extract YAML frontmatter values directly within your hooks.

Are these settings shared with other developers in Git?

No. The pattern uses the .local.md suffix which is intended to be added to .gitignore, keeping configurations private to your local environment.

Plugin Settings Pattern

Name: Plugin Settings Pattern
Author: jasonsie

byjasonsie

0•

Developer Tools

Implements a standardized configuration pattern for Claude Code plugins using YAML frontmatter in local markdown files.

This skill provides a robust framework for managing per-project plugin configurations and state within Claude Code. By utilizing the .claude/plugin-name.local.md file pattern, developers can create user-configurable plugins that store structured data in YAML frontmatter and context-rich instructions in Markdown. It includes practical implementation guides for reading settings from Bash hooks, terminal commands, and AI agents, ensuring seamless integration and persistence across development sessions without polluting your version control system.

Key Features

01Standardized .claude/plugin-name.local.md file structure for configuration

02Integration patterns for Bash hooks, terminal commands, and autonomous agents

03Markdown body support for providing rich context and prompts to AI agents

04Git-safe configuration management using .local.md naming and .gitignore practices

05YAML frontmatter support for structured settings like booleans, strings, and lists

060 GitHub stars

Use Cases

01Creating project-specific behavior toggles for security scans or linting hooks

02Storing local environment preferences and session IDs without committing them to Git

03Managing state for multi-agent workflows and autonomous loop coordination

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jasonsie/prompt-dev plugin-settings

For use in Claude.ai and ChatGPT

Download Skill