SKILL.md frontmatter fields

This table is generated from contracts/skill.schema.json.

For what each field means, see Catalogue authoring standards, section 5 Skill frontmatter and body.

Field	Type	Required	Rules	Description
name	string	yes	pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ minLength: 1 maxLength: 64	Kebab-case skill identifier (1–64 chars).
description	string	yes	maxLength: 1024	Trigger surface shown to IDEs — hard cap 1024 chars (Kiro truncates at byte boundary).
license	string	no
compatibility	object	no	maxProperties: 256 each value: one of: string (maxLength: 1024); boolean; integer (minimum: -9007199254740991, maximum: 9007199254740991); array (maxItems: 256) of [string (maxLength: 1024); boolean; integer (minimum: -9007199254740991, maximum: 9007199254740991)] keys maxLength: 1024	Adapter-compatibility constraints declared by the skill. Values are bounded to the show JSON discovery-compatible scalar/list subset.
metadata	object	no		Open extension table — any additional frontmatter keys must be nested here.
allowed-tools	array of string	no		Explicit tool allowlist for this skill.