VS Code extension skill validator rejects valid frontmatter fields

Status Closed — not planned
Maintainer reply None cached
Activity 9 comments · opened Mar 4, 2026 · closed Jun 2, 2026

Description

The VS Code extension's skill file (SKILL.md) frontmatter validator rejects several valid attributes that are documented and functional in the CLI.

Reproduction

  1. Create a skill with allowed-tools in frontmatter:

``yaml
---
name: commit
description: Commit changes and push to GitHub
disable-model-invocation: true
allowed-tools: Bash(git *)
---
``

  1. Open the file in VS Code with the Claude Code extension (v2.1.66)
  2. Warning appears: Attribute 'allowed-tools' is not supported in skill files. Supported: argument-hint, compatibility, description, disable-model-invocation, license, metadata, name, user-invokable.

Expected

No warning — allowed-tools is a documented frontmatter field per https://code.claude.com/docs/en/skills#frontmatter-reference.

Actual validator vs. docs

| Field | Official docs | Extension validator |
|-------|:---:|:---:|
| name | ✅ | ✅ |
| description | ✅ | ✅ |
| argument-hint | ✅ | ✅ |
| disable-model-invocation | ✅ | ✅ |
| user-invocable | ✅ | ❌ (listed as user-invokable — typo) |
| allowed-tools | ✅ | ❌ missing |
| model | ✅ | ❌ missing |
| context | ✅ | ❌ missing |
| agent | ✅ | ❌ missing |
| hooks | ✅ | ❌ missing |
| compatibility | ❌ not in docs | ✅ listed |
| license | ❌ not in docs | ✅ listed |
| metadata | ❌ not in docs | ✅ listed |

The validator is missing 5 valid fields, includes 3 undocumented fields, and has a typo (user-invokableuser-invocable).

Environment

  • VS Code extension: anthropic.claude-code v2.1.66
  • OS: Windows 11 Pro

View original on GitHub ↗

9 Comments

heathkh-recursion · 5 months ago

have same issue.

<img width="1103" height="23" alt="Image" src="https://github.com/user-attachments/assets/9e7c39ce-3c94-49cc-9b3c-0b4609a8b48c" />

eburgers81 · 5 months ago

same issue here:

<img width="661" height="183" alt="Image" src="https://github.com/user-attachments/assets/47719ab7-6c55-41b9-a306-387aedf32c1e" />

LorenzoNicoletti · 5 months ago

I also have this same issue! Not sure if the allowed-tools is completely ignored or not in this case

kocevaIv · 4 months ago

I have the same issue as well

halcon74 · 3 months ago

I have this issue for context/agent/effort/arguments. Are effort and arguments also officially supported?

github-actions[bot] · 2 months ago

Closing for now — inactive for too long. Please open a new issue if this is still relevant.

MarkRx · 2 months ago

@github-actions reopen

Magic-Man-us · 2 months ago

still a big problem. I dont see any actions being taken anywhere to resolve this.
I see the old threads to actually work on a solution, the AI literally closed both of them, as duplicates of eachother.....

https://github.com/anthropics/claude-code/issues/23330
Closed in favor of duplicate
https://github.com/anthropics/claude-code/issues/23329
which was closed in favor of the duplicate.
https://github.com/anthropics/claude-code/issues/23330

And thus, nothing was fixed.
I am not certain, but perhaps the fix is on vscode to implement.

MarkRx · 1 month ago

You may need to open a new issue... I hate the over aggressive bot on this repo.