Skip to content
BENIBIX Learn

Claude Code Skill Frontmatter

AI⌨️ Claude CodeClaude Code Concepts

Also known as SKILL.md frontmatter, disable-model-invocation, allowed-tools (skill)

The header of a SKILL.md file. It tells Claude what the skill does.

Think of it like

It is like the label on a jar. It tells you what is inside before you open it.

Example

Jack sets his deploy skill so Claude can not start it alone. Now it only runs when he types /deploy.

Why it matters

Claude sees only the header until it needs the skill. A good description is what makes the skill run at the right time.

Definition

Skill frontmatter is the header at the top of a SKILL.md file. It sits between two lines of dashes and is written in YAML. Every field is optional, but the description matters most, because Claude reads it to decide when to use the skill. Other fields can stop Claude from starting the skill by itself, or let it use some tools without asking. A field with a typo is skipped without any error.

Example code

yaml
---
description: Deploys the app. Use when asked to ship.
disable-model-invocation: true
allowed-tools: Bash(npm run *)
---
A clear description, run by hand only, and one kind of command allowed.
The skill's header sits at the top of SKILL.md, between the two dashed lines.

Common mistake

Misspelling a field name. Claude Code ignores it with no warning, so the setting silently does nothing.

Key takeaways

  1. 1
    Description first. Claude picks skills by it.
  2. 2
    All optional. But a description is advised.
  3. 3
    Exact names. A typo is ignored silently.

Learn it properly