SKILL.md uses YAML frontmatter for metadata followed by Markdown instructions:
---name: code-reviewdescription: Code quality analysis with best practices enforcementversion: "1.0.0"license: MITcompatibility: "python>=3.9"allowed-tools: - code_execution - file_searchdependencies: - summarizationmetadata: author: Your Name tags: - code-quality - review---# Code Review SkillYou are an expert code reviewer. When reviewing code:1. Check for bugs, security issues, and performance problems2. Verify adherence to project coding standards3. Suggest improvements with concrete examples## When to Use ScriptsUse `analyze.py` to run static analysis on the provided code.## Reference MaterialsRefer to `style-guide.md` for the project's coding standards.
Frontmatter Fields
Field
Type
Required
Description
name
string
Yes
Unique skill identifier (kebab-case, no spaces or capitals)
description
string
Yes
Short description (shown in skill summaries, max 1024 chars, no XML tags)
version
string
No
Semantic version for version tracking
license
string
No
License information
compatibility
string
No
Runtime requirements (e.g. "python>=3.9")
allowed-tools
list
No
Tools this skill recommends using
dependencies
list
No
Other skill names this skill depends on
metadata
object
No
Arbitrary metadata (author, tags, etc.)
Name Rules
Must be kebab-case (lowercase letters, digits, hyphens only)
Cannot start or end with a hyphen
Cannot contain consecutive hyphens (--)
Max 64 characters
Must match the folder name
Description Rules
Must be a non-empty string, max 1024 characters
Must not contain XML bracket characters (< or >)
Should describe what the skill does and when to use it
Instructions Body
The Markdown body after the frontmatter is the instructions — this is what the agent reads when it calls get_skill_instructions(). Write it as if you’re briefing a colleague:
Explain when and how to apply the skill
Reference available scripts and references by filename
Be specific about expected outputs and quality standards
Keep instructions focused. The agent loads them on demand, so concise and actionable guidance works better than lengthy explanations.
Scripts
Place executable files in scripts/. Agents can read script content or execute them: