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)
  • arguments
  • when_to_use
  • version
  • paths (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)

View original on GitHub ↗

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