free-ai-lab free-ai-lab

How to install Skills

Tutorial

Three install methods — Claude Code / Claude Desktop / Cursor — plus troubleshooting.

In one sentence: Installing a Skill is essentially one thing — put the Skill folder where your AI tool can find it. The path differs per client; here are the three most common install methods.

Before installing, understand this: a Skill is just "files + a folder". You don't need to run any program to install it — just copy the files (or run one command).

Method ①: Claude Code (command line, most common)

If you're a developer, Claude Code is the most common Skill host. Two ways to install:

A. Install someone else's collection (one command)
/plugin marketplace add obra/superpowers ← add a Skill marketplace /plugin install superpowers@workspace ← install to the current project (shared with the team) /plugin install superpowers@user ← install to your account (available in all projects)

Type it directly (starting with a slash) in the Claude Code input box; it takes effect automatically after install.

B. Drop in a Skill directory yourself
# Create a .claude/skills/ directory in your project and put the Skill folder inside my-project/ ├── .claude/ │ └── skills/ │ └── my-skill/ │ ├── SKILL.md │ └── scripts/

After placing it, restart Claude Code (or start a new session) for the Skill to be recognized.

Method ②: Claude Desktop (graphical interface)

  1. Open Claude Desktop → Settings
  2. Go to the Developer area
  3. Find the Skills directory configuration and point your local Skills directory to where you store Skill folders (e.g., ~/skills)
  4. Copy the Skill folder into that directory → restart Claude Desktop

The interface differs slightly between versions; go by the "Skills"-related settings inside your client.

Method ③: Cursor / VS Code-style editors

  1. In your project's root directory, use the corresponding AI plugin's skills directory convention (e.g., Cursor's .cursor/rules/ or the tool's official Skills path)
  2. Put the Skill folder into that directory
  3. Reload the window (Ctrl+Shift+P → Reload Window) to apply

Each IDE's Skill directory convention updates quickly with versions; if it won't install, check the plugin's official docs first.

Troubleshooting common issues

Problem Cause Solution
AI doesn't recognize it after installNo restart / new sessionRestart; check the directory spelling before restarting
The Skill doesn't triggerdescription trigger scope too narrowPut all common phrasings into description (see writing guide)
"Marketplace not found" error/plugin only supported in that versionUpdate the client, or use the "drop-in directory" way
Want to uninstall a SkillDelete the folder or run /plugin uninstall

How to verify it's installed?

  1. Say a trigger scenario directly in an AI chat, e.g., "help me write a weekly report"
  2. Check whether the output follows the Skill's format (e.g., the report uses the "results / problems / plans" three sections)
  3. If it doesn't trigger, check the directory path and description (the two most common sticking points)

Related reading