liveBook · Manning

SKILL.md

Also called skill file

SKILL.md is a Markdown file containing metadata and instructions that define a reusable capability or process for an AI agent.

How 3 Manning books explain it

Vibe Engineering

A skill file is a loadable instruction artifact that defines a reusable process or discipline for an AI agent to follow.

How it is used
Provides selectively loaded procedures that supplement tools without placing every workflow in always-loaded rules.
How deep it goes
Explains file structure, progressive disclosure, selection descriptions, and context cost through a review workflow.
Examples
Illustrates a pull-request review skill with a migration script, checklist, finding categories, and human approval boundary.
What you can do after
Builds a skill folder from scratch with a selection description, procedural instructions, and optional supporting resources.

Read how Vibe Engineering explains SKILL.md →

Build a Multi-Agent System (from Scratch)

SKILL.md is the required Markdown file in an Agent Skills bundle that contains the skill's metadata and instructions.

How it is used
Defines a reusable procedural workflow and gives LLM agents metadata for discovering and using it.
How deep it goes
Specifies frontmatter, body, and optional resources, then validates body readability and nonemptiness without detailing workflow authoring.
Examples
Identifies scripts, reference documents, and assets such as images, prompt templates, and data files as possible bundled resources.
What you can do after
Build it from scratch by defining required metadata, documenting a workflow, and organizing optional resources beside the file.

Read how Build a Multi-Agent System (from Scratch) explains SKILL.md →

Context Engineering

A Markdown file that defines an agent skill's metadata and procedural instructions.

How it is used
Defines reusable, task-specific agent behavior through discovery metadata and procedural instructions.
How deep it goes
Specifies required YAML fields and Markdown procedures, then connects file placement to explicit or automatic activation.
Examples
Uses commit-message generation and meeting-note formatting to demonstrate skill procedures and output constraints.
What you can do after
Build it from scratch by defining activation metadata and procedures, then placing its directory where the agent harness scans.

Read how Context Engineering explains SKILL.md →

What to know first

Related concepts

Questions about SKILL.md

What is SKILL.md?

SKILL.md is a Markdown file containing metadata and instructions that define a reusable capability or process for an AI agent.

Which Manning books explain SKILL.md?

Vibe Engineering, Build a Multi-Agent System (from Scratch) and Context Engineering.

What should I know before learning SKILL.md?

Manning books that teach SKILL.md usually introduce Markdown and agent skills first.

What is SKILL.md a kind of?

SKILL.md is a kind of operational contract. An operational contract is a set of mandatory instructions defining authoritative procedures, output formats, validation checkpoints, and fallback behavior for an agent skill.

What is SKILL.md part of?

SKILL.md is part of skill bundle. A skill bundle is a directory containing a SKILL.md file and the additional resources associated with a skill.

What are the parts of SKILL.md?

SKILL.md includes frontmatter and procedural workflow.

These guides are generated from the text of Manning books by Manning's knowledge graph and link to the sections they draw on. The full books are available on liveBook and at manning.com.