Agent Skills Documentation
Agent Skills are a simple, open format for giving AI agents new capabilities and expertise through folders of instructions, scripts, and resources that agents can discover and use.
Quick Reference
| File | Title | Description |
|---|---|---|
contents/home.mdx | Overview | Introduction to Agent Skills format and its benefits for skill authors, compatible agents, and teams |
contents/what-are-skills.mdx | What are skills? | Core concepts: folder structure, progressive disclosure, and how skills work |
contents/specification.mdx | Specification | Complete format specification including SKILL.md format, frontmatter fields, and optional directories |
contents/integrate-skills.mdx | Integrate skills | Guide for adding Agent Skills support to agents and tools (filesystem-based vs tool-based approaches) |
contents/README.md | Documentation Dev Guide | Development instructions for the Mintlify documentation site |
contents/CLAUDE.md | Claude Code Guidance | Repository-specific instructions for Claude Code when working with Agent Skills docs |
When to use
Use this skill when the user asks about:
- •Creating or authoring Agent Skills
- •SKILL.md file format and specification
- •Agent Skills frontmatter and metadata fields
- •Integrating skills support into AI agents or tools
- •Progressive disclosure and skill activation
- •Skills directory structure and optional folders
- •Differences between filesystem-based and tool-based agents
How to find information
- •Check Quick Reference above for specific topics
- •Read
TOC.mdfor complete file listing - •Read specific files from
contents/{filename}for detailed information