# How do you format skills? Is there a specific format (like YAML)?

Source: https://www.kingscrosslabs.com/guides/claude-code/skill-file-format
Author: Mika Reyes, Nick Reyes (King's Cross Labs)
Published: 2026-05-07
Updated: 2026-11-16
Topic: Skills & .md files

## 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.

> Maven workshop: We build and iterate real skills together in [Master Claude Code as a Non-Technical Pro](https://maven.com/mika-reyes/master-claude-code-as-a-non-technical-pro).

---
Cite this page as: https://www.kingscrosslabs.com/guides/claude-code/skill-file-format