Transcription
Agent skills, the open standard for AI agent capabilities built by Enthropic, adopted by 37 tools. Here is how it works in under three minutes.
A skill is one folder. Inside lives one file: skill.md. That file holds two fields: a name, a description, plus the instructions an agent follows to do the work. That is the whole spec.
A skill is more than just skill.md, though. Drop scripts into a scripts folder and the agent runs them. Drop reference docs into a references folder and the agent reads them on demand. Drop templates into assets and the agent uses them.
Here is the part that makes it actually work: progressive disclosure. Stage one, discovery. At startup, the agent loads only each skill's name and description. About 100 tokens each.
Stage two, activation. When your task matches the description, the full skill.md loads into context.
Stage three, execution. Bundle scripts and reference files only load when the work demands them. Skills stay small until you need them.
This is what a real skill.md looks like. Required fields: a name, a description. Optional fields: a license, compatibility hints, metadata, even pre-approved tools, then markdown instructions. No DSL, no SDK, just a file in your Git repo.
Here is the receipt: 100 tokens to advertise a skill, 5,000 tokens to run it. Zero tokens until activation. Many skills, tiny context footprint.
So where can you use it? Plot code, Cursor, VS Code, OpenAI Codex, and dozens more. Same file, same format, zero rewrites.
The format was originally developed by Entropic, then released as an open standard, open to contributions from anyone in the ecosystem.
So, one question: skills or MCP, which one earns the spot in your stack first? Drop your pick in the comments.
Full spec at agentskills.io.