Prevents accidental data loss by checking for uncommitted changes before running git pull on tracked repos. Use --force to override.
13 KiB
Install, Update & Manage Skills
Init
First-time setup. Auto-detects installed AI CLIs and configures targets.
skillshare init # Interactive setup
skillshare init --dry-run # Preview without changes
What happens:
┌─────────────────────────────────────────────────────────────────┐
│ skillshare init │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 1. Create source directory │
│ → ~/.config/skillshare/skills/ │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 2. Auto-detect AI CLIs │
│ → Found: claude, cursor, codex │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 3. Initialize git (optional) │
│ → Ready for cross-machine sync │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 4. Create config.yaml │
│ → ~/.config/skillshare/config.yaml │
└─────────────────────────────────────────────────────────────────┘
Init Options
| Flag | Description |
|---|---|
--source <path> |
Custom source directory |
--remote <url> |
Set git remote (implies git init) |
--dry-run |
Preview without changes |
Common Scenarios
# Standard setup (auto-detect everything)
skillshare init
# Setup with git remote for cross-machine sync
skillshare init --remote git@github.com:you/my-skills.git
# Use existing skills directory
skillshare init --source ~/.config/skillshare/skills
Overview
┌──────────────────────────────────────────────────────────────┐
│ SKILL LIFECYCLE │
│ │
│ install ──► source ──► sync ──► targets │
│ │ │
│ update │
│ │ │
│ uninstall ──► sync ──► removed from targets │
└──────────────────────────────────────────────────────────────┘
Install
Add skills from GitHub repos, git URLs, or local paths.
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
Discovering skills
─────────────────────────────────────────
→ Source: github.com/anthropics/skills
→ Cloning repository...
✓ Found 17 skill(s)
? Select skills to install:
[arrows to move, space to select, enter to confirm]
> [ ] algorithmic-art
[ ] brand-guidelines
[ ] canvas-design
[x] pdf ← selected
[ ] frontend-design
...
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 git@github.com: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 github.com/team/shared-skills --track
# Installed as: ~/.config/skillshare/skills/_shared-skills/
# Can update with: skillshare update _shared-skills
After Installing
Always sync to distribute to targets:
skillshare install anthropics/skills/skills/pdf
skillshare sync # ← Don't forget!
List
View installed skills and their sources.
skillshare list # Basic list
skillshare list --verbose # Detailed info
Example output:
Installed skills
─────────────────────────────────────────────────────
pdf (github.com/anthropics/skills)
my-skill (local)
_team-repo__frontend__ui (tracked: _team-repo)
personal__writing (local)
Tracked repositories
─────────────────────────────────────────────────────
_team-repo 5 skills, up-to-date
_another-repo 3 skills, has changes
Update
Update skills or tracked repositories.
Update Regular Skills
skillshare update pdf # Update from stored source
skillshare update pdf --dry-run # Preview
How it works:
┌─────────────────────────────────────────┐
│ skillshare update pdf │
└─────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ 1. Read stored source from metadata │
│ → github.com/anthropics/skills/pdf │
└─────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ 2. Re-download from source │
└─────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ 3. Replace skill in source directory │
└─────────────────────────────────────────┘
Update Tracked Repos
skillshare update _team-repo # git pull specific repo
skillshare update team-repo # _ prefix optional
skillshare update --all # Update ALL tracked repos
How it works:
┌─────────────────────────────────────────┐
│ skillshare update _team-repo │
└─────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ cd ~/.config/skillshare/skills/_team-repo
│ git pull │
└─────────────────────────────────────────┘
Safety check: If the repo has uncommitted changes, update is blocked:
skillshare update _team-repo
# → "Repository has uncommitted changes"
# → Shows modified files
# → Requires --force to override
skillshare update _team-repo --force # Update anyway (may cause conflicts)
skillshare update --all # Skips dirty repos, updates others
After Updating
skillshare update _team-repo
skillshare sync # ← Distribute changes to targets
Upgrade
Upgrade the skillshare CLI binary and/or built-in skill.
skillshare upgrade # Both CLI + skill
skillshare upgrade --cli # CLI only
skillshare upgrade --skill # Skill only
skillshare upgrade --force # Skip confirmation
skillshare upgrade --dry-run # Preview
What gets upgraded:
| Component | Location | What happens |
|---|---|---|
| CLI | /usr/local/bin/skillshare |
Downloads latest binary |
| Skill | ~/.config/skillshare/skills/skillshare/ |
Downloads latest skill files |
After upgrading skill:
skillshare upgrade --skill
skillshare sync # ← Update skill in all targets
Uninstall
Remove a skill from source.
skillshare uninstall pdf # With confirmation
skillshare uninstall pdf --force # Skip confirmation
skillshare uninstall pdf --dry-run # Preview
For tracked repos:
skillshare uninstall _team-repo # Checks for uncommitted changes
skillshare uninstall _team-repo -f # Force (ignore uncommitted)
After Uninstalling
skillshare uninstall pdf
skillshare sync # ← Remove from all targets
Related
- sync.md — Sync skills to targets
- team-edition.md — Tracked repos and team sharing
- faq.md — Troubleshooting