A skill is a folder with a SKILL.md file: frontmatter with name and description, then instructions. Claude loads it when the description matches the task. It saves you from repeating style rules every time.
Structure
.claude/skills/gta-asset/
SKILL.md
palette.md # colors and usage
checklist.md # final checks
SKILL.md example
---
name: gta-asset
description: Creates original GTA VI-style animated assets for the guide site. Use when the user asks for animated wallpapers, stings, HUDs or overlays.
---
# Rules
- One HTML file, no external dependencies.
- Palette: see palette.md. Colors as CSS variables.
- Always prefers-reduced-motion and a seamless loop.
- Original artwork: never Rockstar logos, characters, fonts or audio.
# Procedure
1. Pitch concept and palette in 5 lines.
2. Build the asset.
3. Run checklist.md and report what you verified.
Why it works
- Precise description: it says when to use the skill, not just what it does.
- Verifiable rules: “under 200 KB” can be checked, “nice” cannot.
- External checklist: keep
SKILL.mdshort, move details to linked files.
Pair it with the Prompt Lab and the agentic pipeline.
Frequently asked questions
What is a Claude Code skill?
A folder with a SKILL.md file holding name, description and instructions. Claude loads it when the description matches the task.
Where do you save a skill?
In .claude/skills/<name>/SKILL.md.