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 --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/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