[DOCS] Document in the README of your official plugins the syntax for allowing skills to be run automatically without Claude asking for permission
Resolved 💬 5 comments Opened Dec 1, 2025 by PaulRBerg Closed Feb 8, 2026
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://github.com/anthropics/claude-code/tree/main/plugins/plugin-dev
Section/Topic
Skill permissions
Current Documentation
_No response_
What's Wrong or Missing?
The READMEs here:
- https://github.com/anthropics/claude-code/tree/main/plugins/plugin-dev
- https://github.com/anthropics/claude-code/tree/main/plugins
Do not mention anything about the JSON syntax for allowing skills in settings.json, which is this:
{
// Claude Skills
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"permissions": {
"allow": [
"Skill(plugin-dev:hook-development)"
]
}
}
Suggested Improvement
This syntax is not immediately obvious - the plugin name has to be used as a prefix for the actual skill name.
It would be helpful to document it!
Impact
Low - Minor confusion or inconvenience
Additional Context
_No response_
This issue has 5 comments on GitHub. Read the full discussion on GitHub ↗