skills.rest
GongXLiang
GongXLiangCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

plugin-settings

Manage per-project Claude Code plugin settings via YAML frontmatter files.

Updated Apr 26, 2026
Search Tags:#configuration#plugin#settings#claude-code#yaml-frontmatter#per-project
One-click install
npx skills add https://github.com/GongXLiang/plot-study --skill plugin-settings-gongxliang
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plugin-settings
Source: https://github.com/GongXLiang/plot-study/tree/main/.claude/plugins/marketplaces/claude-plugins-official/plugins/plugin-dev/skills/plugin-settings
Command: npx skills add https://github.com/GongXLiang/plot-study --skill plugin-settings-gongxliang

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill addresses the need to manage per-project plugin configuration for Claude Code by using a dedicated local file pattern (.claude/plugin-name.local.md) with YAML frontmatter and a Markdown body to drive behavior at runtime.

Core Features & Use Cases

  • Per-project plugin configuration: store settings in a gitignored, project-scoped location.
  • YAML frontmatter support: define structured fields like enabled, mode, and more for deterministic behavior.
  • Read-into-context: automatic loading of settings during hooks and commands to influence prompts and actions.

Quick Start

Create a file at .claude/plugin-settings.local.md with YAML frontmatter and a Markdown body, then restart Claude Code to load the settings.

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 behavior in Claude Code?▼

You manage per-project plugin configuration by creating a file at .claude/plugin-name.local.md with YAML frontmatter. This stores settings in a gitignored, project-scoped location to drive deterministic plugin behavior at runtime.

What is YAML frontmatter and how does it work for plugin settings?▼

YAML frontmatter defines structured fields like enabled and mode at the top of your local configuration file. It provides deterministic behavior by allowing Claude Code to parse and apply these settings automatically during hooks and commands.

How do I set up a local configuration file for Claude Code plugins?▼

Create a file at .claude/plugin-settings.local.md with YAML frontmatter and a Markdown body, then restart Claude Code to load the settings. This applies robust defaults and validation for safe operation.

Can I use project-scoped configuration without modifying the main repository?▼

Yes, per-project plugin configuration uses a gitignored, project-scoped location under the .claude directory. This allows you to store and apply settings within project repositories without altering the shared codebase.

Why are my Claude Code plugin settings not applying during hooks?▼

Plugin settings may not apply if the YAML frontmatter is invalid or if Claude Code was not restarted after creating the .claude/plugin-settings.local.md file. The skill implements robust defaults and validation to ensure safe operation.

Related Skills

Explore More Software Engineering Skills→
rhpdsrhpds

16-multi-repo-workspaces

Configure Claude Code multi-repository workspaces with CLAUDE.md hierarchy and MCP server scoping.

Official
Intermediate
fcakyonfcakyon
1.0k

plugin-settings

Store per-project plugin configuration in .claude/*.local.md files with YAML frontmatter.

Community
Intermediate
cilangzzzcilangzzz
41

drawio

Generate and export .drawio diagrams to PNG, SVG, or PDF.

Community
Intermediate
Reign-softwareReign-software

hytale-config-files

Define and manage Hytale plugin configuration files with BuilderCodec and Config wrappers.

Official
Intermediate