skills-installer

A CLI tool to install and manage agent skills that comply with the agentskills spec across multiple AI coding clients. Browse and discover available skills at claude-plugins.dev/skills.

Features

• 🔍 Interactive Search - Discover and install skills interactively
• 🚀 Simple CLI - Clean, intuitive command-line interface
• 📦 Skill Registry - Access public agent skills
• 🌍 Global & Local - Install skills globally or per-project
• 🎯 Multi-Client Support - Install skills for different coding clients

Installation

npm install -g skills-installer

Or use directly with npx:

npx skills-installer install @anthropics/skills/frontend-design

What are Agent Skills?

Agent Skills are specialized capabilities that extend AI coding assistants like Claude Code. Each skill follows the agentskills specification - a standard format for defining AI agent capabilities through markdown files with structured instructions.

Usage

Search for skills

Search across all public skills on GitHub:

skills-installer search

Search with a specific query:

skills-installer search "frontend design"

The search command provides an interactive interface where you can:

• Browse and sort skills ranked by relevance, installs, and GitHub stars
• Select a skill to install directly
• Choose installation scope and target client

Install skills

The install command supports multiple formats:

# Browse all skills from an owner
skills-installer install anthropics

# Browse skills in a specific repo
skills-installer install anthropics/claude-code

# Install a specific skill
skills-installer install anthropics/claude-code/frontend-design

# Install all skills resolved from an owner or repo
skills-installer install anthropics/claude-code --all

# `add` is an alias for `install`
skills-installer add anthropics/claude-code/frontend-design

# Install from any GitHub URL
skills-installer install https://github.com/owner/repo/tree/main/skills/my-skill

Install to project directory

skills-installer install anthropics/claude-code/pdf --project
# or
skills-installer install anthropics/claude-code/pdf -p

Project skills are only available in the current project directory.

Update an existing skill

Simply run the install command again - it will automatically update:

skills-installer install anthropics/claude-code/frontend-design

List installed skills

skills-installer list

Shows all installed skills with their installation scope (global/project) and paths.

Target specific clients

skills-installer install @anthropics/skills/xlsx --client shared

Currently supported clients:

• shared - .agents/skills, used by Codex, Amp, Warp, Cursor, OpenCode, Cline, Gemini CLI, GitHub Copilot, and more
• claude-code - .claude/skills
• openclaw - skills in the project, ~/.openclaw/skills globally
• pi - .pi/skills in the project, ~/.pi/agent/skills globally

Common agent IDs that use .agents/skills are accepted as aliases for shared, including opencode, codex, cursor, cline, amp, warp, and github-copilot.

Commands

| Command | Description | |---------|-------------| | search [query] | Search across all public skills on GitHub | | add owner | Alias for install owner | | install owner | Browse all skills from owner's repos | | install owner/repo | Browse skills in a specific repo | | install owner/repo/skill | Install a specific skill | | install <git-url> | Install from HTTPS, SSH, or direct path | | list | List all installed skills |

Options

| Option | Alias | Description | |--------|-------|-------------| | --client <name> | | Target install location | | --project | -p | Install to current project directory | | --all | | Install all resolved skills without opening the skill selector |

Skill Identifier Format

Skills can be identified using multiple formats:

• owner - Browse all skills from owner's repositories
• owner/repo - Browse skills in a specific repository
• owner/repo/skill - Install a specific skill
• https://github.com/owner/repo/tree/main/skills/skill-name - Direct GitHub URL

Where are skills installed?

| Client | Project path | Global path | |--------|--------------|-------------| | shared | ./.agents/skills/ | ~/.agents/skills/ | | claude-code | ./.claude/skills/ | ~/.claude/skills/ | | openclaw | ./skills/ | ~/.openclaw/skills/ | | pi | ./.pi/skills/ | ~/.pi/agent/skills/ |

Examples

# Search for skills interactively
skills-installer search

# Search with a specific query
skills-installer search "frontend design"

# Browse all skills from an owner
skills-installer install anthropics

# Browse skills in a specific repo
skills-installer install anthropics/claude-code

# Install a specific skill globally
skills-installer install anthropics/claude-code/frontend-design

# Install a skill to current project
skills-installer install anthropics/claude-code/frontend-design --project

# Install from a GitHub URL
skills-installer install https://github.com/owner/repo/tree/main/skills/my-skill

# Install skill to the shared .agents/skills location
skills-installer install anthropics/claude-code/frontend-design --client shared

# List all installed skills
skills-installer list

License

MIT