[DOCS] Skills frontmatter docs omit `disallowed-tools` support

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/skills#frontmatter-reference

Section/Topic

Frontmatter reference and Pre-approve tools for a skill

Current Documentation

The docs currently say:

Files in .claude/commands/ still work and support the same [frontmatter](#frontmatter-reference). | allowed-tools | No | Tools Claude can use without asking permission when this skill is active. Accepts a space-separated string or a YAML list. | To block a skill from using certain tools, add deny rules in your permission settings instead.

What's Wrong or Missing?

This page still documents allowed-tools as the only tool-related frontmatter field for skills and says tool blocking must be done in settings.

That is outdated as of v2.1.152. The changelog says:

Skills and slash commands can now set disallowed-tools in frontmatter to remove tools from the model while the skill is active

The current skills page does not mention disallowed-tools in the frontmatter reference, does not explain how it behaves, and still points readers to settings-only deny rules instead.

Because .claude/commands/*.md files use the same frontmatter, this also leaves custom slash commands undocumented for the same capability.

Suggested Improvement

Update the skills page to document disallowed-tools alongside allowed-tools.

Suggested changes:

1. Add a disallowed-tools row to the frontmatter reference table.
2. Explain that a bare tool name removes that tool from the model while the skill or command is active.
3. Add a short example showing both allowed-tools and disallowed-tools in skill frontmatter.
4. Replace the settings-only guidance with wording that distinguishes per-skill or per-command frontmatter from global permission settings.

For example, the tool restrictions section could say that allowed-tools pre-approves tools, while disallowed-tools removes selected tools for the duration of the active skill or custom slash command.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/skills | 135, 207-223, 338-355 | Says .claude/commands/ use the same frontmatter, lists allowed-tools, but omits disallowed-tools and says blocking tools must be done in settings |
| https://code.claude.com/docs/en/changelog | 13-16 | v2.1.152 release note announces disallowed-tools frontmatter for skills and slash commands |

Total scope: 1 primary documentation page appears outdated, with 1 changelog reference confirming the newer behavior.

Relevant version: v2.1.152