What is an agent skill?
A skill is a folder of instructions your AI loads only when a task needs it. Learn what that means, how it…
Guides
Agent skills
How to install a skill
Three ways to add a skill to your AI tool: a one-line command, a downloaded folder, or a zip. Includes where the…
Write your first SKILL.md
Create a working skill in ten minutes: the file layout, the header, the instructions and a first test. Includes a copy-ready template.
Write a skill description that actually triggers
The description decides whether your skill ever loads. Learn what to put in it, with weak and strong examples and a quick…
Add scripts and reference files to a skill
When one file is not enough: split long background into reference files, and add scripts for steps that must be exact. Includes…
How to test and improve a skill
A simple loop for finding out whether your skill works: write test prompts, compare with and without it, fix what fails.
Skill best practices and common mistakes
Twelve habits of skills that work, and the mistakes that make them fail: vague descriptions, giant files, hidden assumptions and more.
Share your skill on Promptsio
Three ways to publish: paste your SKILL.md, upload a zip, or share a link. What we check, what happens after you submit,…