
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-codeInstalls 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 GitHubSponsors
Details
- Repository
- github.com/anthropics/claude-code
- First seen
- Jun 3, 2026