[DOCS] Skill tool docs still say built-in slash commands cannot be invoked
Documentation Type
Incorrect/outdated documentation
Documentation Location
https://code.claude.com/docs/en/skills
Section/Topic
Restrict Claude's skill access and the duplicated built-in-command guidance on slash-commands
Current Documentation
The docs currently say on both skills and slash-commands:
By default, Claude can invoke any skill that doesn't havedisable-model-invocation: trueset. Skills that defineallowed-toolsgrant Claude access to those tools without per-use approval when the skill is active. Your permission settings still govern baseline approval behavior for all other tools. Built-in commands like/compactand/initare not available through the Skill tool.
The command reference also shows the built-in commands affected by this change:
/init| Initialize project with aCLAUDE.mdguide./review| Deprecated. Install thecode-reviewplugin instead./security-review| Analyze pending changes on the current branch for security vulnerabilities.
What's Wrong or Missing?
Changelog v2.1.108 says:
The model can now discover and invoke built-in slash commands like/init,/review, and/security-reviewvia the Skill tool.
That directly contradicts the current Skill tool documentation, which still says built-in commands like /init are not available through the Skill tool.
As written, the docs give users the wrong mental model for how built-in slash commands interact with the Skill tool:
- they imply built-in slash commands are excluded from model discovery and invocation
- they do not explain that built-in commands such as
/init,/review, and/security-revieware now part of the Skill-tool-discoverable command surface - they make the permission and invocability guidance in
skills/slash-commandsoutdated after v2.1.108
Suggested Improvement
Update the Skill tool documentation in both skills and slash-commands to reflect the v2.1.108 behavior.
Minimum fix:
- Replace the blanket statement that built-in commands like
/compactand/initare unavailable through the Skill tool. - Explicitly document that the model can now discover and invoke built-in slash commands such as
/init,/review, and/security-reviewvia the Skill tool. - If some built-in commands are still excluded, document the real exceptions explicitly instead of grouping
/initwith them. - Add a short note near the permission guidance explaining that this change affects how users should reason about Skill-tool access to built-in slash commands.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/skills | Primary Skill tool invocability rules |
| https://code.claude.com/docs/en/slash-commands | Duplicates the same outdated Skill tool restriction |
| https://code.claude.com/docs/en/commands | Built-in command reference for /init, /review, and /security-review |
Total scope: 3 pages affected
Source: Changelog v2.1.108
Exact changelog entry:
The model can now discover and invoke built-in slash commands like/init,/review, and/security-reviewvia the Skill tool
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗