Find Skills
Overview
Two main workflows:
- Local search — browse already-installed skills under
~/.cursor/skills/and.cursor/skills/ - Remote install — pull a skill from a GitHub repository using the
npx skillsCLI
1. Search locally installed skills
Personal skills (available in all projects):
~/.cursor/skills/
Project skills (current repo only):
.cursor/skills/
To list what's installed, read the SKILL.md frontmatter in each subdirectory. The description field explains what the skill does and when to trigger it.
2. Install a skill from GitHub
Syntax
npx skills add <github-repo-url> --skill <skill-name>
Example
npx skills add https://github.com/vercel-labs/skills --skill find-skills
Steps
- Identify the GitHub repository that hosts the skill collection.
- Identify the skill name (subdirectory name inside the repo's
skills/or root folder). - Run the
npx skills addcommand above in the terminal. - The CLI installs the skill into
~/.cursor/skills/<skill-name>/by default. - Verify installation by checking that
~/.cursor/skills/<skill-name>/SKILL.mdexists.
Flags
| Flag | Description |
|---|---|
--skill <name> |
Name of the specific skill to install |
--dir <path> |
Override install directory (default: ~/.cursor/skills/) |
--project |
Install into .cursor/skills/ (project-scoped) instead |
3. Browse a GitHub skills repository
To see all available skills in a repo before installing:
npx skills list https://github.com/<owner>/<repo>
This lists all available skill names with their descriptions so you can pick the right one.
Tips
- After installing a new skill, restart Cursor or reload the window so the agent picks it up.
- Skill names are case-sensitive and use lowercase-with-hyphens convention.
- If a skill already exists locally,
npx skills addwill prompt before overwriting.