What is a SKILL.md file (and why it matters in 2026)
Toby Banks — Founder, Skillzy
The dispatch
New listings, creator interviews, the occasional discount. Every other Friday.
Every working AI agent is a stack of small, specific capabilities. A SKILL.md file is how you hand the agent one of those capabilities — cleanly, repeatably, without re-explaining it every time.
The short version
A SKILL.md is a Markdown file with a small header (what the skill is, what tools it can touch) and a body that tells the agent exactly how to do one job: the intent, the inputs, the steps, the output. You drop it into your agent’s skills folder. The agent picks it up. Done.
Why a file, not a prompt?
Prompts evaporate. A file is versioned, shareable, and reviewable. It survives a model upgrade. It can be sold, bought, and improved by someone who is not you. That is the whole basis of a skills marketplace.
- Portable — the same file works across Claude, OpenClaw, and most agents
- Reviewable — a human can read it before trusting it
- Composable — ten small skills beat one giant prompt
What good looks like
A good SKILL.md does one thing. It names the failure mode it solves. It is boring to read, which is the point — boring is predictable, and predictable is what you want running unattended.
Featured listingYour first SKILL.md, the right way.
The short version of "how to publish a skill people will actually buy."
Your first SKILL.md, the right way · $9 →If you are writing your own, start with the guide above. If you would rather buy one that already works, the catalogue is full of them.
Liked this? Get the next one.
Field Notes, every other Friday. No spam.