Skillshare CLI
Two Modes
code
Global: ~/.config/skillshare/skills → ~/.claude/skills, ~/.cursor/skills, ... Project: .skillshare/skills/ → .claude/skills, .cursor/skills (per-repo)
Auto-detection: commands run in project mode when .skillshare/config.yaml exists in cwd.
Force with -p (project) or -g (global).
Quick Start
bash
# Global skillshare status && skillshare sync # Project — initialize in a repo skillshare init -p skillshare sync
Commands
| Category | Commands | Project? |
|---|---|---|
| Inspect | status, diff, list, doctor | ✓ (auto) |
| Sync | sync, collect | ✓ (auto) |
| Remote | push, pull | ✗ (use git) |
| Skills | new, install, uninstall, update, check, search | ✓ (-p) |
| Targets | target add/remove/list | ✓ (-p) |
| Security | audit [name] | ✓ (-p) |
| Trash | trash list|restore|delete|empty | ✓ (-p) |
| Log | log [--audit] [--tail N] | ✓ (-p) |
| Backup | backup, restore | ✗ |
| Web UI | ui | ✓ (-p) |
| Upgrade | upgrade [--cli|--skill] | — |
Workflow: Most commands require sync afterward to distribute changes.
AI Usage Notes
Non-Interactive Mode
AI cannot respond to CLI prompts. Always use flags:
bash
# Global init skillshare init --copy-from claude --all-targets --git # If skills exist skillshare init --no-copy --all-targets --git # Fresh start # Project init (in repo root) skillshare init -p --targets "claude-code,cursor" # Specific targets skillshare init -p # Interactive (user only) # Install (multi-skill repo non-interactive) skillshare install user/repo --all # Install all skillshare install user/repo -s pdf,commit # Select specific skillshare install user/repo -y # Auto-accept skillshare install user/repo --force # Override audit block # Add new agents later skillshare init --discover --select "windsurf,kilocode" skillshare init -p --discover --select "windsurf"
Safety
Security audit: install auto-scans skills. CRITICAL findings block install; use --force to override.
bash
skillshare audit # Scan all skills skillshare audit my-skill # Scan specific skill skillshare install user/repo --force # Override CRITICAL block
Soft-delete: uninstall moves skills to trash (7-day retention). Restore with trash restore.
bash
skillshare trash list # See trashed skills skillshare trash restore my-skill # Undo uninstall skillshare trash empty # Permanent delete all
NEVER rm -rf symlinked skills — deletes source. Always use:
- •
skillshare uninstall <name>to remove skills (goes to trash) - •
skillshare target remove <name>to unlink targets
Finding Skills
bash
skillshare search # Browse popular skills skillshare search <query> # Interactive install skillshare search <query> --list # List only skillshare search <query> --json # JSON output
Query examples: react performance, pr review, commit, changelog
References
| Topic | File |
|---|---|
| Init flags (global + project) | init.md |
| Sync/collect/push/pull | sync.md |
| Install/update/uninstall/new | install.md |
| Status/diff/list/search/check | status.md |
| Security audit | audit.md |
| Trash (soft-delete) | trash.md |
| Operation log | log.md |
| Target management | targets.md |
| Backup/restore | backup.md |
| Web dashboard (UI) | ui.md |
| Troubleshooting | TROUBLESHOOTING.md |