How to Create a SKILL.md File
June 15, 2025by SkillTip Team9 min read
A SKILL.md file is the contract between your tool and an AI assistant. This guide covers structure, naming, and best practices.
Basic structure
---
name: my-skill
description: What this skill does
---
# My Skill
Instructions for the AI assistant...
Best practices
- Keep descriptions specific and actionable.
- Include examples of when to use the skill.
- Document required environment variables.
- Add security notes for sensitive operations.