GUIDE
How to use & install
What is a skill?
A skill is a set of files that teaches an AI agent how to carry out a specific job. At its core is an instruction file called SKILL.md, optionally accompanied by reference material (references/), templates and helper scripts. The agent automatically loads skills that match the task at hand and works through their steps.
Getting a skill
- Use “Log in” at the top right to log in with Google, GitHub or your email address.
- On the skill's page, press “Download” (free) or “Buy” (paid). Paid skills are paid by card on Stripe's payment page.
- You can download your skills again at any time from My account.
Installation
Unzipping the file gives you one folder named after the skill. Copy that whole folder into your agent's skills folder.
| Claude Code (all projects) | ~/.claude/skills/<skill-name>/SKILL.md |
|---|---|
| Claude Code (one project) | <project>/.claude/skills/<skill-name>/SKILL.md |
| Hermes Agent | ~/.hermes/skills/<skill-name>/SKILL.md |
| Other agents | If the agent supports the SKILL.md format, use its skills folder. If not, have the agent read SKILL.md as instructions. |
Example for macOS / Linux:
unzip my-skill-1.0.0.zip -d ~/.claude/skills/Example for Windows (PowerShell):
Expand-Archive my-skill-1.0.0.zip -DestinationPath $HOME\.claude\skills\After copying, restart the agent (or start a new session). In Claude Code, check that the skill appears in the list, for example with/skills.
Using skills safely
- Read through
SKILL.mdand any bundled scripts before using a skill. AI Skill Market reviews skills before publishing them, but this does not guarantee safety in every environment. - Do not write API keys or passwords directly into skill files. Use environment variables or each tool's authentication features.
- If you are worried that a file has been tampered with, compare the SHA-256 shown on the page with the hash of the file you downloaded.
Troubleshooting
- Check that the folder is not nested twice (
skills/my-skill/my-skill/SKILL.md). - Check that the
nameanddescriptionat the top of SKILL.md are still there. Agents use this description to choose skills. - If that does not solve it, please contact us through the contact form with the name of the skill.