SKILL.md Frontmatter

ValidatorSkillsOfficial docsSkills frontmatter reference

Skills are defined as SKILL.md files in skill directories. The YAML frontmatter controls the skill's behavior, visibility, and tool access.

Fields

Field	Type	Required	Description
name	string	yes	Lowercase with hyphens, max 64 chars, no reserved words (anthropic, claude)
description	string	yes	Min 10 chars, third-person voice
argument-hint	string	no	Hint text for skill arguments
disable-model-invocation	boolean	no	Prevent model from invoking this skill
user-invocable	boolean	no	Whether users can invoke directly via /skill-name
version	string	no	Semantic version (e.g., 1.0.0) (claudelint extension)
model	string	no	sonnet, opus, haiku, or inherit (valid values)
effort	string	no	low, medium, high, or max
context	string	no	fork (valid values)
agent	string	no	Agent name (required when context: fork)
allowed-tools	string[]	no	Tool names to allow
tags	string[]	no	Categorization tags (claudelint extension)
hooks	object	no	Hooks configuration

Cross-field validations:

• When context is fork, the agent field is required

Example

---
name: deploy-staging
description: Deploys the current branch to the staging environment using the project's CI pipeline.
user-invocable: true
version: 1.0.0
model: sonnet
allowed-tools:
  - Bash
  - Read
tags:
  - deployment
  - ci
---