VS Code skill frontmatter validator: typo in 'user-invokable' and incomplete field list
Resolved 💬 4 comments Opened Feb 21, 2026 by kopandante Closed Feb 21, 2026
Bug
The VS Code extension's SKILL.md frontmatter validator has two issues:
1. Typo: user-invokable instead of user-invocable
When using an unsupported attribute like user_invocable, the error message suggests user-invokable (with k):
Attribute 'user_invocable' is not supported in skill files.
Supported: argument-hint, compatibility, description, disable-model-invocation, license, metadata, name, user-invokable.
However, the runtime reads user-invocable (with c):
// from wmT() in the Claude Code binary (v2.1.50)
h = O["user-invocable"] === undefined ? true : aFR(O["user-invocable"])
The official docs also use user-invocable (with c).
Following the VS Code suggestion leads to a field that the runtime silently ignores.
2. Incomplete field list
The validator only accepts 8 fields:argument-hint, compatibility, description, disable-model-invocation, license, metadata, name, user-invokable
The runtime actually reads these additional fields (verified in binary v2.1.50):
allowed-tools(documented)model(documented)context(documented)agent(documented)hooks(documented)argumentswhen_to_useversionpaths(conditional activation by glob patterns)
Using any of these valid fields triggers a false-positive validation error in VS Code.
Environment
- Claude Code: 2.1.50
- VS Code extension: anthropic.claude-code-2.0.75-darwin-arm64
- OS: macOS (Darwin, arm64)
This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗