Plugin Settings

Store per-project plugin settings in YAML frontmatter within .claude/plugin-name.local.md files.

Updated Jan 13, 2026
One-click install
npx skills add https://github.com/lusya123/cloudcode --skill plugin-settings-lusya123
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Plugin Settings
Source: https://github.com/lusya123/cloudcode/tree/main/claude-code-main/plugins/plugin-dev/skills/plugin-settings
Command: npx skills add https://github.com/lusya123/cloudcode --skill plugin-settings-lusya123

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Per-project plugin configuration is scattered across repositories, causing drift and manual overhead; this skill provides a standardized pattern to store per-project settings in a single file with YAML frontmatter and a Markdown body.

Core Features & Use Cases

  • Centralized per-project configuration stored in .claude/plugin-name.local.md with YAML frontmatter for structured settings.
  • Supports enabling/disabling plugins, default values, and lifecycle notes (restart requirement) in the plugin docs.
  • Use cases include per-repo customization, stateful plugin behavior, and per-project prompts or prompts templates stored alongside code.

Quick Start

Create a .claude/plugin-name.local.md file in your project, add YAML frontmatter and a Markdown body, then restart Claude Code to apply changes.

Frequently Asked Questions about Plugin Settings

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

FAQPage Schema
How do I manage per-project plugin configuration in Claude Code?▼

Manage per-project plugin configuration by storing YAML frontmatter in .claude/plugin-name.local.md files. This pattern provides a standardized way to store structured settings and context prompts alongside your repository code.

What is the best way to customize plugin behavior for a specific repository?▼

Customizing plugin behavior for a specific repository is done using a .claude/plugin-name.local.md file. It uses a simple YAML frontmatter schema for settings and a Markdown body to feed activation prompts.

How do I enable or disable plugins and set default values per project?▼

Enable, disable, and set default values for plugins by defining them within the YAML frontmatter of your local configuration file. This structured format centralizes per-repo customization and stateful behavior.

Can I store project-specific prompts and context directly in my codebase?▼

Yes, you can store project-specific prompts and context by adding a Markdown body below the YAML frontmatter in your local configuration file. This feeds prompts directly to the plugin during activation.

Why are my per-project settings not applying after updating the YAML frontmatter?▼

Per-project settings stored in the YAML frontmatter may not apply because Claude Code requires a restart to load the updated configuration. Always restart the application after modifying the local file.