Skip to content

What is SKILL.md?

A markdown file format used to declare an agent skill's interface, triggers, and behavioral contract.

SKILL.md is a convention for defining AI agent skills in a human-readable markdown file. The file typically specifies the skill's name, a natural-language description of when and how it should be invoked, its input schema, output expectations, and any guardrails or constraints. By using a standardized file format, teams can version-control skills alongside application code, review them in pull requests, and share them across projects. The format bridges the gap between developer intent and agent behavior, serving as both documentation and runtime configuration.