Frontmatter is YAML metadata at the beginning of a skill’s SKILL.md file, before the procedural workflow. It helps an LLM agent discover and use the skill. section 6.1.2
Table 6.1 Fields that can be included in a skill’s frontmatter
|
Field
|
Required
|
Description
|
|
name
|
Yes
|
A unique
identifier for the skill. Must be lowercase letters, numbers, and hyphens
only. Cannot start or end with a hyphen. Maximum 64 characters.
|
|
description
|
Yes
|
Describes
what the skill’s procedural workflow does and in what scenarios it should be
applied. Maximum 1024 characters.
|
|
license
|
No
|
The name of
the license that covers the skill (e.g. MIT) or the name of the license file
that is bundled in the skills resources.
|
|
compatibility
|
No
|
Describes
any environment constraints or requirements the skill has. Maximum 500
characters.
|
|
metadata
|
No
|
An
arbitrary key-value map for additional properties not covered by the
standard, like author or version.
|
|
allowed-tools
|
No
|
A
space-delimited list of tools (each specified by name) the LLM agent can use
to execute the skill.
|
The required fields are name and description; optional fields add licensing, compatibility requirements, arbitrary metadata, and allowed tools. section 6.1.2
