Skills & .md files
How do you format skills? Is there a specific format (like YAML)?
By Mika Reyes and Nick Reyes ·
Short answer
A Claude skill is a Markdown file, optionally starting with YAML frontmatter that gives it a name and a one-line description. Below that, write clear sections such as instructions, output format, and examples. Keep each skill to roughly 100–300 words, and split it into two skills if it grows much longer.
The longer answer
Skills are Markdown. Optional YAML-style frontmatter helps Claude parse intent quickly—this pattern works well:
---
name: Generate Tweet
description: Creates an on-brand tweet in Phantom's voice
---
You are writing a tweet for [Brand]. Match the examples below.
INSTRUCTIONS:
- Under 280 characters
- Punchy and direct
- No hashtags unless clearly relevant
- Lead with the product benefit
EXAMPLES:
[paste 3–5 example tweets here]Keep each skill tight—often roughly 100–300 words. If it balloons, split it. Clear section headers ("INSTRUCTIONS", "OUTPUT FORMAT") beat walls of prose.
Related questions
Learn Claude Code hands-on
These answers come from our Maven Lightning Lesson Q&A. To build your own agent setup with CLAUDE.md, skills, and MCPs step by step, join Master Claude Code as a Non-Technical Pro or browse all Claude Code for Non-Technical Pros guides.
Using an AI assistant? Give it the Markdown version of this answer.