⚡ claude-skills

Install Claude skills from GitHub with a single command.

npx claude-skills add https://github.com/you/your-skills --skill agentic-systems-architect

Install

No install needed — run directly with npx:

npx claude-skills <command>

Or install globally:

npm install -g claude-skills

Commands

add — Install a skill

# Install a specific skill from a GitHub repo
npx claude-skills add https://github.com/owner/repo --skill skill-name

# Shorthand repo format
npx claude-skills add owner/repo --skill skill-name

# If the repo only has one skill, --skill is optional
npx claude-skills add https://github.com/owner/repo

# Install from a specific branch
npx claude-skills add https://github.com/owner/repo --skill skill-name --branch dev

# Install to a custom directory
npx claude-skills add https://github.com/owner/repo --skill skill-name --path ~/my-skills

list — See installed skills

npx claude-skills list

remove — Uninstall a skill

npx claude-skills remove skill-name
# or
npx claude-skills rm skill-name

info — Preview skills in a repo before installing

npx claude-skills info https://github.com/owner/repo

where — Show the skills directory path

npx claude-skills where

How it works

1. Fetches the GitHub repo tree via the GitHub API (no auth required for public repos)
2. Finds all folders containing a SKILL.md file
3. Downloads the skill files directly from GitHub raw content
4. Installs them into your Claude skills directory

Skill detection

Skills are detected as any folder in the repo that contains a SKILL.md file. Pre-packaged .skill zip files are also supported.

Installation directory

Skills are installed in this priority order:

1. --path flag (explicit override)
2. $CLAUDE_SKILLS_DIR environment variable
3. ~/.claude/skills (default)
4. ~/.config/claude/skills
5. macOS: ~/Library/Application Support/Claude/skills
6. Windows: %APPDATA%/Claude/skills
7. Linux: ~/.local/share/claude/skills

Structuring your repo for this CLI

Your GitHub repo just needs skill folders with a SKILL.md inside:

your-skills-repo/
├── agentic-systems-architect/
│   ├── SKILL.md          ← required
│   └── references/
│       └── advanced-patterns.md
├── social-content-strategist/
│   └── SKILL.md
└── README.md

Then anyone can install with:

npx claude-skills add https://github.com/you/your-skills-repo --skill agentic-systems-architect

Publishing your own skills

1. Create a GitHub repo with your skill folders
2. Share the install command:

   npx claude-skills add https://github.com/you/repo --skill your-skill

3. That's it — no npm publishing required on your end

License

MIT