SKILL.md
SKILL.md is a Markdown file containing metadata and instructions that define a reusable capability or process for an AI agent.
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.
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.
What to know first
- MarkdownMarkdown is a lightweight markup language that uses readable plain-text syntax to represent structured and formatted documents.
- agent skillsAgent Skills is an open standard for packaging reusable capabilities so compatible AI agents can discover and use them.
Related concepts
- frontmatterhas part · YAML front matter is a delimited metadata block at the beginning of a document, formatted using YAML syntax.
- Markdownuses · Markdown is a lightweight markup language that uses readable plain-text syntax to represent structured and formatted documents.
- agent skillpart of · An agent skill is a reusable package of instructions, capabilities, or resources that guides an AI agent in carrying out a task or workflow.
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.


