[BUG] Skill frontmatter validator reports allowed-tools as unsupported despite being valid per docs

Resolved 💬 3 comments Opened Feb 19, 2026 by danjuarez79 Closed Feb 22, 2026

Preflight Checklist

  • [x] I have searched existing issues and this hasn't been reported yet
  • [x] This is a single bug report (please file separate reports for different bugs)
  • [x] I am using the latest version of Claude Code

What's Wrong?

Warning says field is unsupported. The validator's known-field list (argument-hint, compatibility, description, disable-model-invocation, license, metadata, name, user-invokable) is missing fields documented as valid: allowed-tools, model, context, agent, hooks

What Should Happen?

No warning — field is documented at code.claude.com/docs/en/skills.md

Error Messages/Logs

Attribute 'allowed-tools' is not supported in skill files. Supported: argument-hint, compatibility, description, disable-model-invocation, license, metadata, name, user-invokable.

Steps to Reproduce

Add allowed-tools: Read, Grep to a SKILL.md frontmatter block, observe the warning

Claude Model

Sonnet (default)

Is this a regression?

I don't know

Last Working Version

_No response_

Claude Code Version

2.1.47 (Claude Code)

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

Terminal.app (macOS)

Additional Information

_No response_

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗