# Claude Code Skill Frontmatter

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

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** SKILL.md frontmatter, disable-model-invocation, allowed-tools (skill)

## Think of it like

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

## 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

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

## 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.

## 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.

## Common mistake

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

## Three principles

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

## Related terms

- [Claude Code Skill](https://learn.benibix.com/term/ai/claude-code-skill)
- [Front Matter](https://learn.benibix.com/term/development/front-matter)
- [YAML Ain't Markup Language (YAML)](https://learn.benibix.com/term/development/yaml)
- [Agent Skill](https://learn.benibix.com/term/ai/agent-skill)
- [/skills Command](https://learn.benibix.com/term/ai/skills-command)

## Taught in

- [Skills, Plugins and Styles](https://learn.benibix.com/learn/ai-claude-code/skills-plugins-and-styles): Claude Code, 14/16

![Three files side by side, each with a header between two lines of dashes. A subagent file in .claude/agents with name, description, tools and model. A SKILL.md with description and allowed-tools. A plugin.json in .claude-plugin with name, version and description.](https://learn.benibix.com/diagrams/ai8-cc-extension-files.svg)

---

Source: https://learn.benibix.com/term/ai/claude-code-skill-frontmatter
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-19
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
