sidebar_position
Quick Reference
Command cheat sheet for skillshare.
Core Commands
| Command |
Description |
init |
First-time setup |
install <source> |
Add a skill |
uninstall <name>... |
Remove one or more skills |
list |
List all skills |
search <query> |
Search for skills |
sync |
Push to all targets |
status |
Show sync state |
Skill Management
| Command |
Description |
new <name> |
Create a new skill |
update <name> |
Update a skill (git pull) |
update --all |
Update all tracked repos |
check |
Check for skill updates |
check --json |
Check for updates (JSON output) |
upgrade |
Upgrade CLI and built-in skill |
hub list |
List configured skill hubs |
hub add <url> |
Add a skill hub |
Target Management
| Command |
Description |
target list |
List all targets |
target <name> |
Show target details |
target <name> --mode <mode> |
Change sync mode |
target add <name> <path> |
Add custom target |
target remove <name> |
Remove target safely |
diff [target] |
Show differences |
| Command |
Description |
extras init <name> --target <path> |
Add an extras entry to config |
extras list |
List configured extras with sync status |
extras remove <name> |
Remove an extras entry from config |
extras collect <name> |
Collect local files from extras target into source |
Sync Operations
| Command |
Description |
sync extras |
Sync non-skill resources (rules, commands, etc.) |
sync --all |
Sync skills + extras together |
collect <target> |
Collect skills from target to source |
collect --all |
Collect from all targets |
backup [target] |
Create backup |
backup --list |
List backups |
restore <target> |
Restore from backup |
push [-m "msg"] |
Push to git remote |
pull |
Pull from git and sync |
trash list |
List soft-deleted skills |
trash restore <name> |
Restore a soft-deleted skill |
Utilities
| Command |
Description |
analyze |
Analyze context window usage (interactive TUI) |
analyze --filter <text> |
Filter skills by name/path substring |
analyze --json |
Context usage as JSON |
doctor |
Diagnose issues |
doctor --json |
Diagnose issues (JSON output for CI) |
log |
View operations and audit logs |
ui |
Launch web dashboard on localhost:19420 |
ui -p |
Launch web dashboard in project mode |
version |
Show CLI version |
make test-docker |
Run offline Docker sandbox tests |
make playground |
Start playground + enter shell (one step) |
make playground-down |
Stop and remove playground |
./scripts/sandbox.sh <cmd> |
Advanced sandbox management (up/down/shell/reset/status/logs/bare) |
make ui-build |
Build frontend |
make build-all |
Full binary with frontend |
Common Workflows
Install and sync a skill
Create and deploy a skill
Cross-machine sync
Optional later (only if you install additional AI CLIs after setup):
With mode override during discover, only newly added targets are affected:
Team skill sharing
Sandbox playground session
Key Paths
| Path |
Description |
~/.config/skillshare/config.yaml |
Configuration file |
~/.config/skillshare/skills/registry.yaml |
Installed skill registry (auto-managed) |
~/.config/skillshare/skills/ |
Source directory |
~/.config/skillshare/extras/<name>/ |
Extras source directories |
~/.local/state/skillshare/logs/ |
Operation and audit logs |
~/.local/share/skillshare/backups/ |
Backup directory |
Flags Available on Most Commands
| Flag |
Description |
--dry-run, -n |
Preview without making changes |
--help, -h |
Show help |
See Also