SKILL.md frontmatter validator missing 'allowed-tools' and other valid attributes
Summary
The SKILL.md frontmatter validator reports a false-positive warning for allowed-tools and likely several other attributes that are valid and functional.
Diagnostic message:
Attribute 'allowed-tools' is not supported in skill files. Supported: argument-hint, compatibility, description, disable-model-invocation, license, metadata, name, user-invocable.
Details
The Claude Code native binary correctly parses and uses allowed-tools from SKILL.md frontmatter (visible in the bundled code as BR(q["allowed-tools"]) → allowedTools), but the validation allowlist that generates IDE diagnostics does not include it.
The same code also parses these attributes which may also be missing from the allowlist:
contextagentargumentswhen_to_useversionmodelpaths
Reproduction
- Create a SKILL.md with
allowed-toolsin the frontmatter:
```yaml
---
name: my-skill
description: Example skill
allowed-tools:
- Bash
- Read
---
```
- Open the file in VS Code with the Claude Code extension
- Observe the warning diagnostic on the
allowed-toolslines
Expected behavior
No warning should be emitted for allowed-tools or other attributes that are parsed and used by Claude Code.
Environment
- Claude Code extension version: 2.1.74
- VS Code (Remote - Codespaces)
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗