IDE validator does not recognize 'allowed-tools' in skill frontmatter
Resolved 💬 3 comments Opened Feb 11, 2026 by TadashiEguchi Closed Feb 11, 2026
Description
The VS Code extension (Claude Code IDE integration) reports a warning for the allowed-tools field in skill YAML frontmatter:
Attribute 'allowed-tools' is not supported in skill files. Supported: compatibility, description, license, metadata, name.
However, allowed-tools is a valid field documented in both:
- agentskills.io specification (listed as experimental)
- Claude Code documentation (code.claude.com) — with syntax examples like
Bash(git:*)
The IDE validator's allowlist does not include allowed-tools, causing a false warning.
Steps to Reproduce
- Create a skill file at
.claude/skills/<name>/SKILL.md - Add
allowed-tools: Bash(git:*)to the YAML frontmatter - Open the file in VS Code with the Claude Code extension installed
- Observe the warning on the
allowed-toolsline
Expected Behavior
allowed-tools should be recognized as a valid frontmatter attribute without any warning.
Actual Behavior
Warning: Attribute 'allowed-tools' is not supported in skill files. Supported: compatibility, description, license, metadata, name.
Related Issues
- anthropics/skills#249 — skill-creator rejects valid optional fields
- #18837 —
allowed-toolsnot correctly applied in some cases - #18737 —
allowed-toolssupport inconsistency between CLI and Agent SDK
Environment
- Claude Code VS Code Extension (latest)
- macOS
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗