claude-skills CLI

Install Claude skills from any GitHub registry with a single command.

Install

npm install -g claude-skills

Or use directly with npx (no install needed):

npx claude-skills <command>

Usage

List available skills in a registry

npx claude-skills list https://github.com/YOUR_USERNAME/YOUR_REPO

Output:

Skills in https://github.com/YOUR_USERNAME/YOUR_REPO
Registry version: 1.0.0

SKILL                           VERSION   DESCRIPTION
--------------------------------------------------------------------------------
article-content                 1.4.0     Write article body content, blog posts...
article-structure               1.0.0     Structure and outline articles...
writing-style-personal-voice    1.0.0     Apply a personal writing voice...
brainstorm                      1.0.0     Brainstorm ideas and angles...

Install a single skill

npx claude-skills add https://github.com/YOUR_USERNAME/YOUR_REPO --skill article-content

Install all skills

npx claude-skills add https://github.com/YOUR_USERNAME/YOUR_REPO --all

Install to a custom destination

# Project-level (default: .claude/skills)
npx claude-skills add https://github.com/YOUR_USERNAME/YOUR_REPO --skill brainstorm

# Global
npx claude-skills add https://github.com/YOUR_USERNAME/YOUR_REPO --skill brainstorm --dest ~/.claude/skills

Skills are installed as

<dest>/<skill-name>/SKILL.md

Claude picks them up automatically from .claude/skills/ in your project or ~/.claude/skills/ globally.

Publish your own registry

1. Create a GitHub repo with this structure:

   registry.json
   skills/
     my-skill/
       SKILL.md

2. Fill in registry.json (see the example registry for the schema)
3. Share the repo URL — anyone can install from it with this CLI

Requirements

Node.js 18+