install
Add skills from GitHub repos, git URLs, or local paths.
Overview
┌──────────────────────────────────────────────────────────────┐
│ SKILL LIFECYCLE │
│ │
│ install ──► source ──► sync ──► targets │
│ │ │
│ update │
│ │ │
│ uninstall ──► sync ──► removed from targets │
└──────────────────────────────────────────────────────────────┘
Quick Examples
# From GitHub (shorthand)
skillshare install anthropics/skills/skills/pdf
# Browse available skills in a repo
skillshare install anthropics/skills
# From local path
skillshare install ~/Downloads/my-skill
# As tracked repo (for team sharing)
skillshare install github.com/team/skills --track
GitHub Shorthand
Use owner/repo format — automatically expands to github.com/owner/repo:
skillshare install anthropics/skills # Browse mode
skillshare install anthropics/skills/skills/pdf # Direct install
skillshare install ComposioHQ/awesome-claude-skills # Another repo
Discovery Mode (Browse Skills)
When you don't specify a path, skillshare lists all available skills:
skillshare install anthropics/skills
Tip: Use --dry-run to preview without installing:
skillshare install anthropics/skills --dry-run
Direct Install (Specific Path)
Provide the full path to install immediately:
# GitHub with subdirectory
skillshare install anthropics/skills/skills/pdf
skillshare install google-gemini/gemini-cli/packages/core/src/skills/builtin/skill-creator
# Full URL
skillshare install github.com/user/repo/path/to/skill
# SSH URL
skillshare install [email protected]:user/repo.git
# Local path
skillshare install ~/Downloads/my-skill
skillshare install /absolute/path/to/skill
Options
| Flag | Short | Description |
|---|---|---|
--name <name> | Custom name for the skill | |
--force | -f | Overwrite existing skill |
--update | -u | Update if exists (git pull or reinstall) |
--track | -t | Keep .git for tracked repos |
--dry-run | -n | Preview only |
Common Scenarios
Install with custom name:
skillshare install google-gemini/gemini-cli/.../skill-creator --name my-creator
# Installed as: ~/.config/skillshare/skills/my-creator/
Force overwrite existing:
skillshare install ~/my-skill --force
Update existing skill:
# By skill name (uses stored source)
skillshare install pdf --update
# By source URL
skillshare install anthropics/skills/skills/pdf --update
Install team repo (tracked):
skillshare install anthropics/skills --track
After Installing
Always sync to distribute to targets:
skillshare install anthropics/skills/skills/pdf
skillshare sync # ← Don't forget!