anthropics avatar

Plugin Settings

This is the pattern for storing user configuration in Claude Code plugins using local markdown files with YAML frontmatter. Drop a `.claude/plugin-name.local.md` file in your project root, put structured settings in the frontmatter, and use the markdown body for prompts or context. It's per-project, stays out of git, and gets read by hooks, commands, and agents. If you're building a plugin that needs user-configurable state or project-specific settings, this is the established way to do it. The approach is straightforward: YAML for data, markdown for everything else, and the `.local.md` suffix keeps it out of version control by convention.

GitHub stars
141.9K
last updated
Aug 21, 2026

Install

$ npx -y skills add anthropics/claude-code --skill 'Plugin Settings' --agent claude-code

Installs into .claude/skills of the current project.

Files

This is the pattern for storing user configuration in Claude Code plugins using local markdown files with YAML frontmatter. Drop a `.claude/plugin-name.local.md` file in your project root, put structured settings in the frontmatter, and use the markdown body for prompts or context. It's per-project, stays out of git, and gets read by hooks, commands, and agents. If you're building a plugin that needs user-configurable state or project-specific settings, this is the established way to do it. The approach is straightforward: YAML for data, markdown for everything else, and the `.local.md` suffix keeps it out of version control by convention.

Browse the repository on GitHub

Sponsors

Details

Repository
github.com/anthropics/claude-code
First seen
Jun 3, 2026

More from anthropics/claude-code

All 10

Recommended

1juliusbrussee avatarcavemanjuliusbrussee/cavemanUltra-compressed communication mode. Cuts output tokens 65% (measured) by speaking like caveman while keeping full technical accuracy. Supports intensity levels618.3Kskills.sh installs
2mattpocock avatargrill-memattpocock/skillsA relentless interview to sharpen a plan or design.1.5Mskills.sh installs
3shadcn avatarimproveshadcn/improveSurvey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on s40Kskills.sh installs
4obra avatarsystematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes326.7Kskills.sh installs
5forrestchang avatarkarpathy-guidelinesforrestchang/andrej-karpathy-skillsBehavioral guidelines to reduce common LLM coding mistakes through explicit assumptions, simplicity, and verifiable success criteria.17.9Kskills.sh installs
6vercel-labs avatarfind-skillsvercel-labs/skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express int4.3Mskills.sh installs