Updated
How to install a skill
How to install a skill
Installing an agent skill means downloading the package and placing its folder where your agent looks for skills. The exact location depends on your runtime, but the shape is the same everywhere: one folder with a SKILL.md at its root.
1. Download the ZIP
After you buy a skill or grab a free one, download the ZIP from My Library. Skillsh stores the archive exactly as it was uploaded, so what you download is the complete package, SKILL.md and all.
2. Check the package before you install
Unzip the archive and look at the folder. It should look like this:
code-review-checklist/
SKILL.md
references/
checklist.md
Two things are worth confirming before you trust a skill:
- The folder name matches the
namefield insideSKILL.md. - The
descriptionin the frontmatter matches what you expected to install.
This takes ten seconds and catches a mislabeled or tampered archive before it ever runs.
3. Place the folder in your skills directory
Each runtime keeps skills in its own directory. The runtime reads the description from every SKILL.md it finds there at startup, then opens the full instructions when a task matches. Copy the whole folder — including scripts/, references/, and assets/ if present — into that directory.
If you don't know where your tool looks, check its documentation for "skills directory". The folder itself stays unchanged: that portability is the point of the standard.
4. Verify it loaded
Ask your agent something related to the skill and confirm it follows the instructions. For a code-review skill, ask it to review a small pull request. If it applies the checklist without being reminded, the install worked.
5. If nothing happens
- Restart the agent so it re-scans the skills directory.
- Confirm the folder name is lowercase, numbers, and single hyphens — no spaces or underscores.
- Re-open
SKILL.mdand make sure the frontmatter block is intact.
Where to go next
Now that one is running, browse the Skillsh catalog for more, or read what makes a good skill so you can tell the keepers from the rest.