AI

What are agent skills? SKILL.md explained

Agent skills explained: how a SKILL.md file teaches an AI agent a repeatable workflow, how agents load skills only when needed, and how they differ from tools.

  • 7 min read
  • 5 questions
  • +35 XP
Transcript

Agent Skills, explained by cats. Kitty has an AI agent. She gives it tools. Terminal. Browser. APIs. Very nice. Then Kitty says, “Update the docs.” “Check the API.” “Open a PR.” The agent tries. But gets messy. Wrong steps. Wrong order.

Too much guessing. Chaos. So Kitty uses skills A skill is a small guide for the agent. What task to do. What tools to use. What steps to follow. What mistakes to avoid. Often this lives in SKILL.md file. At first, the agent only reads the skill name.

And the short description. Just enough to know, “This is the release skill.” “This is the API skill.” Then when the task matches, it opens the full skill and follows it. So instead of guessing, the agent loads the right workflow at the right time.

Skills are not just small prompts. They can include steps, rules, examples, templates, and guardrails. That means less chaos, and more repeatable results. That’s agent skills. Tools to act. Skills to work. And Tuna delivered on time for Kitty.