[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:

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_

View original on GitHub ↗

This issue has 5 comments on GitHub. Read the full discussion on GitHub ↗