Write a skill
A skill is reusable knowledge and instructions packaged in a single SKILL.md file. No code — just markdown an agent can reach for.
Create a skill folder.
Make a folder named for your skill and put a single SKILL.md inside it. That file is the whole skill.
You'll bundle it with an agent or install it later — for now, the folder and the file are all you need.
market-analysis/
└─ SKILL.md
---
name: Market Analysis
description: Analyze comps and price a
listing from recent neighborhood sales.
triggers: [pricing, comps, valuation]
---
Add YAML frontmatter.
name and description are required. The description is what the agent reads to discover the skill, so make it clear and specific.
triggers help discovery ranking too — but they don't force activation. The agent always decides whether to use the skill.
Write the body.
Below the frontmatter, the markdown body is the actual instructions and knowledge the agent follows when it uses the skill.
Optional scripts/, references/, and assets/ folders load on demand — progressive disclosure keeps the skill lightweight until it's actually needed.
market-analysis/
├─ SKILL.md
├─ scripts/
├─ references/
└─ assets/
Loaded on demand, not up front.