[DOCS] Syntax for allowed-tools in skills

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/skills#restrict-tool-access-with-allowed-tools

Section/Topic

Syntax for allowed-tools in skills

Current Documentation

_No response_

What's Wrong or Missing?

I'm trying to write a plugin that bundles an MCP server and a skill with a workflow using that MCP server. I want the skill to be able to invoke the MCP server's tools automatically, without permission check.

However, don't see how to use the allowed-tools field to achieve this.

The specification suggests a whitespace-separated list of tools, the Anthropic Docs have a comma-separated list. Both only show built-in tools as example.

I tried writing it like this, mimicking the syntax used in .claude/settings.local.json, but claude still asks for permission before executing the startreview() tool:

# SKILL.md
---
name: local-reviewing
description: Starts a local code review session
allowed-tools: mcp__plugin_local-review_local-review__startreview
---

Suggested Improvement

Either the docs should provide an example, or unambiguously state that only the built-in tools are supported by claude code for this field.

Impact

High - Prevents users from using a feature

Additional Context

_No response_