--- sidebar_position: 4 --- # Quick Reference Command cheat sheet for skillshare. ## Core Commands | Command | Description | |---------|-------------| | `init` | First-time setup | | `install ` | Add a skill | | `uninstall ...` | Remove one or more skills | | `list` | List all skills | | `search ` | Search for skills | | `sync` | Push to all targets | | `status` | Show sync state | ## Skill Management | Command | Description | |---------|-------------| | `new ` | Create a new skill | | `update ` | 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 ` | Add a skill hub | ## Target Management | Command | Description | |---------|-------------| | `target list` | List all targets | | `target ` | Show target details | | `target --mode ` | Change sync mode | | `target add ` | Add custom target | | `target remove ` | Remove target safely | | `diff [target]` | Show differences | ## Extras Management | Command | Description | |---------|-------------| | `extras init --target ` | Add an extras entry to config | | `extras list` | List configured extras with sync status | | `extras remove ` | Remove an extras entry from config | | `extras collect ` | Collect local files from extras target into source | ## Agent Management | Command | Description | |---------|-------------| | `list agents` | List installed agents | | `install --kind agent` | Install only agents from a repo | | `install -a ` | Install specific agent(s) by name | | `uninstall --kind agent ` | Remove an agent | | `sync agents` | Sync only agents to targets | | `check agents` | Check agents for updates | | `audit agents` | Security scan agents | | `enable --kind agent ` | Re-enable a disabled agent | | `disable --kind agent ` | Disable an agent via `.agentignore` | ## Sync Operations | Command | Description | |---------|-------------| | `sync extras` | Sync non-skill resources (rules, commands, etc.) | | `sync --all` | Sync skills + extras together | | `collect ` | Collect skills from target to source | | `collect --all` | Collect from all targets | | `backup [target]` | Create backup | | `backup --list` | List backups | | `restore ` | Restore from backup | | `commit [-m "msg"]` | Create a local git commit without pushing | | `push [-m "msg"]` | Commit and push to git remote | | `pull` | Pull from git and sync | | `trash list` | List soft-deleted skills | | `trash restore ` | Restore a soft-deleted skill | ## Utilities | Command | Description | |---------|-------------| | `analyze` | Analyze context window usage (interactive TUI) | | `analyze --filter ` | 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 | | `completion --install` | Install shell tab-completion (bash/zsh/fish/powershell/nushell) | | `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 ` | 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 ```bash skillshare install anthropics/skills/skills/pdf skillshare sync ``` ### Create and deploy a skill ```bash skillshare new my-skill # Edit ~/.config/skillshare/skills/my-skill/SKILL.md skillshare sync ``` ### Cross-machine sync ```bash # Setup (pick one) # Interactive (guided prompts) skillshare init --remote git@github.com:you/my-skills.git # Non-interactive (no prompts, auto-detect installed targets) skillshare init --remote git@github.com:you/my-skills.git --no-copy --all-targets --no-skill # Optional local checkpoint without pushing skillshare commit -m "Save local skill edits" # Machine A: push changes skillshare push -m "Add new skill" # Machine B: pull and sync skillshare pull ``` Optional later (only if you install additional AI CLIs after setup): ```bash skillshare init --discover ``` With mode override during discover, only newly added targets are affected: ```bash skillshare init --discover --select cursor --mode copy ``` ### Team skill sharing ```bash # Install team repo skillshare install github.com/team/skills --track # Install from specific branch (works with or without --track) skillshare install github.com/team/skills --branch develop --all skillshare install github.com/team/skills --track --branch develop # Update from team skillshare update --all skillshare sync ``` ### Sandbox playground session ```bash make playground # start + enter shell skillshare --help ss status exit # leave shell make playground-down # stop container ``` --- ## Key Paths | Path | Description | |------|-------------| | `~/.config/skillshare/config.yaml` | Configuration file | | `~/.config/skillshare/skills/.metadata.json` | Installed skill metadata (auto-managed) | | `~/.config/skillshare/skills/` | Skill source directory | | `~/.config/skillshare/agents/` | Agent source directory | | `~/.config/skillshare/extras//` | 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 - [Commands Reference](/docs/reference/commands) — Full command documentation - [Concepts](/docs/understand) — Core concepts explained