How do I prevent settings from being committed to Git?

You should add .claude/*.local.md to your project's .gitignore file to ensure project-specific or environment-specific configurations remain local.

Do I need to restart Claude Code after changing settings?

Yes, settings changes typically require a restart of Claude Code for hooks to recognize the updated configuration as they are loaded at session start.

Why use .local.md instead of a standard JSON file?

The .local.md format allows for both structured YAML data and human-readable markdown instructions, making it easier for Claude to read and for users to document configuration.

Where should I store my plugin settings?

Following this pattern, settings should be stored in the project root under the .claude/ directory using the naming convention plugin-name.local.md.

Can I use this for multi-agent coordination?

Yes, this pattern is ideal for storing agent-specific state, task numbers, and coordinator session IDs, allowing multiple agents to sync via the file system.

Plugin Settings Pattern

Name: Plugin Settings Pattern
Author: Claude-Code-Community-Ireland

byClaude-Code-Community-Ireland

•

生产力与工作流

Standardizes how Claude Code plugins store and access per-project configuration using local markdown files with YAML frontmatter.

This skill provides a robust architectural pattern for making Claude Code plugins user-configurable without hardcoding values. By utilizing .claude/*.local.md files, developers can implement project-specific settings, manage agent states, and control hook execution via structured YAML frontmatter and descriptive markdown content. It includes practical implementation guides for Bash hooks, custom commands, and multi-agent coordination, ensuring a consistent and git-safe approach to plugin customization that works seamlessly with Claude's environment.

主要功能

01Git-safe local configuration practices via .gitignore integration

02Bash-ready patterns for reading settings within lifecycle hooks

03YAML frontmatter parsing for structured configuration data

04Standardized .claude/plugin-name.local.md file structure

05Markdown body support for detailed prompts and context

066 GitHub stars

使用场景

01Configuring validation levels and file size limits for automated tools

02Storing state and task assignments for multi-agent swarms

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

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add claude-code-community-ireland/claude-code-resources plugin-settings

For use in Claude.ai and ChatGPT

Download Skill