Skill.md: An open standard for agent skills
a month ago
- #Mintlify
- #documentation
- #AI-agents
- skill.md is a markdown file that describes how agents should use a product and can be installed into major coding agents.
- Mintlify documentation sites include a default skill.md file at /.well-known/skills/default/skill.md.
- Users can replace the autogenerated skill.md by placing their own file in the root of their project's git repository.
- install.md is being deprecated in favor of skill.md, which includes both installation and usage knowledge.
- Agents often produce poor code because documentation is written for humans, not optimized for AI context limitations.
- skill.md provides agents with up-to-date context, improving code quality by consolidating best practices and product specifics.
- The file should include decision tables, explicit boundaries, gotchas, and links to more detailed documentation.
- Mintlify regenerates skill.md with each doc update to ensure it contains the latest information.
- Users are encouraged to customize their skill.md to reflect personal preferences and improve agent performance.