Description
plugin-settings is an agent skill from Anthropic's official plugins collection, listed on skills.sh. It describes a pattern for Claude Code plugins to store user-configurable settings and state. A plugin keeps its settings in a file named after the plugin, inside the project's .claude folder, for example .claude/plugin-name.local.md. The file uses YAML frontmatter for structured configuration, with a markdown body for prompts or extra context. The pattern is for per-project configuration and state, read by a plugin's hooks, commands and agents. The file is managed by the user, so it is not meant to be committed to git, and the skill says it should be listed in .gitignore. The skill covers the file structure and a basic template to start from. It is for plugin authors who want their plugin to take settings from each project, and for users who need to know where those settings live and why they should not be committed.…
Highlights
- Per-project settings in .claude/plugin-name.local.md
- YAML frontmatter plus markdown body
- Read from hooks, commands and agents
- Basic template for a new settings file
Ratings & Reviews
No ratings yet
Be the first to rate plugin-settings.
People also visit
canvas-design
Create beautiful visual art in .png and .pdf documents using design philosophy
plugin-settings FAQ
What does the plugin-settings skill describe?
A pattern for Claude Code plugins to keep user-configurable settings and state in a per-project file.
How do I install it?
Run: npx skills add https://github.com/anthropics/claude-plugins-official --skill plugin-settings
Where is the settings file?
In the .claude folder of the project root, named after the plugin, such as .claude/plugin-name.local.md.
Should I commit the settings file?
No. The skill says the file is user-managed and should be listed in .gitignore.
Has it been checked for security?
skills.sh lists three audits: Gen Agent Trust Hub Pass, Socket Pass and Snyk Pass.
What are the best plugin-settings alternatives?
Popular alternatives to plugin-settings include implement, brand-guidelines and canvas-design. See all plugin-settings alternatives