Learn · Format and Reference

Format and Reference guides

How SKILL.md and related files are put together.

Format and ReferenceArticleHow to write a SKILL.md: a step-by-step guide (2026)Write your first SKILL.md in six steps: one job, a matching name, a description agents can match, a short body, extra files, and a real check.Format and ReferenceArticleSKILL.md format explained: files, fields and limits (2026)The SKILL.md format explained from the open spec and the Claude Code docs: the folder layout, the two required fields, the size limits and how agents load it.Format and ReferenceArticleWhat is SKILL.md frontmatter? Every field, in plain English (2026)What SKILL.md frontmatter is, which fields are required, which ones Claude Code adds, and the mistakes that stop a skill from loading or uploading.

Other topics