skills.rest
mmrakt
mmraktCOMMUNITY
Explore all skills by this author →
Website𝕏@mmrakt0716GitHub

plugin-settings

Load per-project plugin configuration from .claude/*.local.md files into Claude Code.

Updated Jun 6, 2025
Search Tags:#validation#hooks#claude-code#yaml-frontmatter#project-config#plugin-settings
One-click install
npx skills add https://github.com/mmrakt/dotfiles --skill plugin-settings-mmrakt
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plugin-settings
Source: https://github.com/mmrakt/dotfiles/tree/main/.claude/skills/plugin-settings
Command: npx skills add https://github.com/mmrakt/dotfiles --skill plugin-settings-mmrakt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill enables per-project plugin configuration for Claude Code by storing settings in a dedicated local file, ensuring project-specific behavior while keeping configuration isolated from global defaults.

Core Features & Use Cases

  • Per-project configuration file: .claude/plugin-name.local.md centralizes plugin state and options.
  • YAML frontmatter + Markdown body: frontmatter defines settings (enabled, mode, limits) and body carries prompts or contextual notes.
  • Hooks, commands, and agents: settings drive behavior across the toolchain and can be read deterministically or on-demand in workflows.

Quick Start

Create or update a YAML frontmatter block in .claude/plugin-name.local.md with fields like enabled and mode, then restart Claude Code for the changes to take effect.

Frequently Asked Questions about plugin-settings

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure per-project plugin settings for Claude Code?▼

Per-project plugin settings for Claude Code are configured by creating a .claude/plugin-name.local.md file with YAML frontmatter to define fields like enabled and mode, isolating project behavior from global defaults.

What is YAML frontmatter and how does it apply to Claude Code hooks?▼

YAML frontmatter is a metadata block at the top of Markdown files that defines configuration settings like enabled, mode, and dependencies. It drives behavior across Claude Code hooks, commands, and agents deterministically.

How do I enable or disable a Claude Code plugin for a specific repository?▼

To enable or disable a plugin for a specific repository, update the enabled field in the YAML frontmatter of your .claude/plugin-name.local.md file, then restart Claude Code for the changes to take effect.

Does Claude Code require a restart to apply local plugin configuration changes?▼

Yes, Claude Code requires a restart to apply changes made to local plugin configuration files. The skill enforces validation and restart requirements to ensure settings are correctly loaded into the active plugin state.

What are the limitations or security considerations when using local plugin settings?▼

Limitations include potential misconfiguration or leakage if files are improperly named or ignored. The skill enforces validation, documentation guidance for file naming, gitignore rules, and security considerations to prevent these issues.

Related Skills

Explore More Software Engineering Skills→
jeffpeckyjeffpecky

plugin-settings

Manage Claude Code plugin settings in .local.md files with YAML frontmatter.

Community
Intermediate
LeighAtkinsLeighAtkins

Plugin Settings

Manage per-project plugin settings via YAML frontmatter in .claude/plugin-name.local.md files.

Community
Intermediate
rhpdsrhpds

10-hooks

Create Claude Code hooks that guard and monitor tool execution workflows.

Official
Intermediate
brixtonphambrixtonpham

plugin-settings

Configure Claude Code plugins per project using .local.md files with YAML frontmatter.

Community
Intermediate