mgiovani/ai-arsenal / skills/find-skills
find-skills
VerifiedSearch, install, update, and remove third-party Agent Skills from skills.sh or any GitHub/GitLab repo via the `npx skills` CLI. Use when the user wants to "find a skill", "install a skill from github", "search skills.sh", or add third-party capabilities to Claude Code/Cursor/other agents. Not for authoring new skills (see create-skill).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.2 KB |
| evals/evals.json | config | 4.0 KB |
| evals/trigger-eval.json | config | 1.8 KB |
| references/commands.md | markdown | 6.6 KB |
| references/workflows.md | markdown | 6.4 KB |
references/commands.md
View on GitHub# CLI Command Reference
Reference for the `npx skills` CLI tool (npm package: `skills`, maintained by Vercel Labs). This is a third-party tool this repo doesn't control. If a flag below doesn't behave as documented, run `npx skills <command> --help` and trust that output over this file.
## Contents
- [Installation](#installation)
- [Commands](#commands)
- [Installation Paths (Claude Code)](#installation-paths-claude-code)
- [Troubleshooting](#troubleshooting)
## Installation
The CLI requires no installation, only Node.js (`fnm install --lts` or `brew install node`). Run it directly via `npx`:
```bash
npx skills <command> [options]
```
Or install globally for faster execution:
```bash
npm install -g skills
skills <command> [options]
```
---
## Commands
### `find`: Search the skills.sh Directory
Search for skills across the skills.sh ecosystem.
```bash
npx skills find # Interactive fuzzy search (fzf-style)
npx skills find <query> # Search by keyword
```
**Examples:**
```bash
npx skills find typescript
npx skills find react hooks
npx skills find "code review"
npx skills find testing
```
---
### `add`: Install Skills from Repositories
Install skills from Git repositories into agent skill directories.
```bash
npx skills add <source> [options]
```
**Source formats:**
| Format | Example |
|--------|---------|
| GitHub shorthand | `owner/repo` |
| GitHub URL | `https://github.com/owner/repo` |
| Direct skill path | `https://github.com/owner/repo/tree/main/skills/name` |
| GitLab URL | `https://gitlab.com/org/repo` |
| Git SSH URL | `git@github.com:owner/repo.git` |
| Local directory | `./my-local-skills` |
**Flags:**
| Flag | Short | Description |
|------|-------|-------------|
| `--global` | `-g` | Install to home directory instead of project |
| `--agent <agents...>` | `-a` | Target specific agents (e.g., `claude-code`, `cursor`) |
| `--skill <skills...>` | `-s` | Install specific skills by name |
| `--list` | `-l` | List available skills without installing |
| `--yes` | `-y` | Skip confirmation prompts |
| `--all` | | Install all skills to all agents (no prompts) |
**Examples:**
```bash
# List available skills in a repo
npx skills add vercel-labs/agent-skills --list
# Interactive install (prompts for skill and agent selection)
npx skills add vercel-labs/agent-skills
# Install specific skill to Claude Code
npx skills add vercel-labs/agent-skills --skill frontend-design -a claude-code
# Install globally
npx skills add owner/repo --skill my-skill -a claude-code -g
# Non-interactive (for CI/CD or scripting)
npx skills add vercel-labs/agent-skills --skill frontend-design -g -a claude-code -y
# Install all skills to all detected agents
npx skills add vercel-labs/agent-skills --all
# Install from a local directory
npx skills add ./my-skills-repo
```
**Installation methods** (prompted during interactive install):
- **Symlink** (recommended): Creates symbolic links to a canonical copy. Single source of truth, easy to update.
- **Copy**: Creates independent copies for each agent. Use when symlinks are not supported.
---
### `list` (alias: `ls`): View Installed Skills
Display all installed skills across agents.
```bash
npx skills list [options]
npx skills ls [options]
```
**Flags:**
| Flag | Short | Description |
|------|-------|-------------|
| `--global` | `-g` | Show global skills only |
| `--agent <agents...>` | `-a` | Filter by specific agents |
**Examples:**
```bash
# All installed skills (project + global)
npx skills list
# Global skills only
npx skills ls -g
# Filter by agent
npx skills ls -a claude-code
npx skills ls -a claude-code -a cursor
```
---
### `remove` (alias: `rm`): Uninstall Skills
Remove installed skills.
`-y`/`--all` exist so the CLI itself skips its own prompts. That's for scripted/CI use, not a license for the agent to skip *its* confirmation. List what's installed and get the user's explicit yes before running any `remove`/`rm` command; see SKILL.md's "Ask First" section.
```bash
npx skills remove [name] [options]
npx skills rm [name] [options]
```
**Flags:**
| Flag | Short | Description |
|------|-------|-------------|
| `--global` | `-g` | Remove from global scope |
| `--agent <agents...>` | `-a` | Target specific agents; use `'*'` for all |
| `--skill <skills...>` | `-s` | Specify skills to remove; use `'*'` for all |
| `--yes` | `-y` | Skip confirmation prompts |
| `--all` | | Shorthand for `--skill '*' --agent '*' -y` |
**Examples:**
```bash
# Interactive removal
npx skills remove
# Remove specific skill
npx skills remove web-design-guidelines
# Remove from global scope
npx skills remove --global web-design-guidelines
# Remove from specific agents
npx skills remove --agent claude-code my-skill
# Remove all skills (no confirmation)
npx skills remove --all
# Remove all skills from one agent
npx skills rm --skill '*' -a cursor
```
---
### `check`: Check for Updates
Check whether installed skills have newer versions available.
```bash
npx skills check
```
---
### `update`: Update Installed Skills
Update all installed skills to their latest versions.
```bash
npx skills update
```
---
### `init`: Create a New Skill
Generate a new skill template with proper SKILL.md structure.
```bash
npx skills init # Create SKILL.md in current directory
npx skills init my-skill # Create in a named subdirectory
```
---
## Installation Paths (Claude Code)
| Scope | Path |
|-------|------|
| Project | `.claude/skills/<skill-name>/SKILL.md` |
| Global | `~/.claude/skills/<skill-name>/SKILL.md` |
The CLI also supports Cursor, Codex, Gemini CLI, GitHub Copilot, and other agents. It auto-detects installed agents and prompts for target selection. Run `npx skills add <source> --help` or check `npx skills --help` for the full, current agent list rather than relying on a list here, which will drift out of sync with the CLI.
---
## Troubleshooting
### Skills not found in a repository
Verify the repository contains `SKILL.md` files in expected locations:
```bash
# List skills before installing
npx skills add owner/repo --list
```
If no skills appear, the repository may not follow the Agent Skills directory convention. Check for `SKILL.md` files in the repo root or `skills/` directory.
### Permission errors on global install
Ensure write access to the home directory agent paths:
```bash
ls -la ~/.claude/skills/
```
### Symlink vs copy issues
On Windows or restricted filesystems, symlinks may fail. Use copy mode when prompted, or reinstall with the copy method.
### Stale skills after update
If `npx skills update` does not reflect changes, remove and reinstall:
```bash
npx skills remove my-skill
npx skills add owner/repo --skill my-skill -a claude-code
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |