liveBook · Manning

Frontmatter

As explained in Build a Multi-Agent System (from Scratch)

Frontmatter is metadata placed at the beginning of a structured document and separated from its main content.

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

How Build a Multi-Agent System (from Scratch) covers it

How deep it goes
Defines the frontmatter’s location and purpose, then lists required and optional fields with constraints and descriptions.
Examples
Uses a SKILL.md file with name and description fields, plus optional license and allowed-tools fields.
What you can do after
Configure a skill’s identifier, description, environment constraints, metadata, license, and permitted tools.
How it connects
Connects skills to YAML, SKILL.md files, LLM agents, and procedural workflows.

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Build a Multi-Agent System (from Scratch). The section links point to the parts of the book it draws on.