Files
skillshare/website/docs/getting-started/quick-reference.md
T
Krishnaswamy Subramanian eb9b2b28f9 feat(plugin): add --all flag to plugin update and enable antigravity-cli updates (#656)
* Add --all flag to plugin update and enable agy

Add -a/--all to skillshare plugin update so users can update all
tracked plugins in a single command without tying slow target CLI runs
to skillshare update --all or sync --all.

- Reject --all outside plugin update or when combined with a plugin
  name or --source-ref
- Share source repository discoveries and discovery errors across the
  Preview and Apply lifecycle via Service.WithDiscoveryCache so multi-
  plugin marketplaces are cloned at most once per command
- Isolate source, manifest, and target failures per binding when --all
  is active so healthy plugins update while partial failures exit
  non-zero and leave failed bindings unchanged in config.yaml
- Skip unfiltered OMP bindings during --all updates so sibling targets
  on the same package still update without failing the batch
- Enable plugin update for antigravity-cli while skipping disabled
  plugins when agy extensions list reports an entry as disabled

Closes #653

* Add plugin update --all to docs and completions

Advertise -a/--all for skillshare plugin across all five shell
completion scripts and document the bulk update workflow and
antigravity-cli update support in the user and built-in skill docs.

- Add --all and -a to plugin completions in bash, zsh, fish,
  PowerShell, and Nushell with TestPluginCompletionsIncludeAllFlag
- Document update [NAME | --all], -a/--all, and antigravity-cli source
  updates in website/docs/reference/commands/plugin.md (and its
  zh-Hans, zh-Hant, ja, and ko translations), sharing-plugins.md, and
  quick-reference.md
- Document plugin update --all and antigravity-cli enablement checks in
  skills/skillshare/references/plugins.md

* Require known enabled state for native updates

Require a matching EnabledKnown && Enabled inventory entry before
updating copilot or antigravity-cli bindings, and align the localized
plugin workflow pages with the English docs.

- Skip copilot and antigravity-cli updates in Service.Preview and
  refuse reinstallation in applyNativeTarget when the binding is absent
  from native inventory or not known to be enabled
- Cover absent native inventory in
  TestAntigravityCLIUpdateRespectsEnablement
- Synchronize plugin update [name | --all] and Antigravity CLI update
  guidance across the ja, ko, zh-Hans, and zh-Hant copies of
  quick-reference.md and sharing-plugins.md
2026-10-27 20:57:43 +08:00

247 lines
8.5 KiB
Markdown

---
sidebar_position: 4
---
# 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 |
| `link <path>` | Link a folder of your own skills into the source |
| `unlink <name>` | Remove a link from the source |
| `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 |
| `move <name>... <folder>` | Move installed skills or folders into another folder, keeping install records |
| `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 |
## Extras Management
| Command | Description |
|---------|-------------|
| `extras init <name> --target <path>` | Add an extras entry to config |
| `extras init <name> --file <file> --target <path>` | Add an extra that syncs one file (`--as` renames it at targets) |
| `extras list` | List configured extras with sync status |
| `extras remove <name>` | Remove an extras entry from config |
| `extras <name> --add-target <path>` | Add a target to an existing extras entry |
| `extras <name> --remove-target <path>` | Remove a target (add `--prune` to delete synced files) |
| `extras collect <name>` | Collect local files from extras target into source |
## Agent Management
| Command | Description |
|---------|-------------|
| `list agents` | List installed agents |
| `install <source> --kind agent` | Install only agents from a repo |
| `install <source> -a <name>` | Install specific agent(s) by name |
| `uninstall --kind agent <name>` | Remove an agent |
| `sync agents` | Sync only agents to targets |
| `check agents` | Check agents for updates |
| `audit agents` | Security scan agents |
| `enable --kind agent <name>` | Re-enable a disabled agent |
| `disable --kind agent <name>` | Disable an agent via `.agentignore` |
## Plugin Management
| Command | Description |
|---------|-------------|
| `plugin` | Open the interactive plugin manager |
| `plugin list` | Show managed plugins and native installation state |
| `plugin discover <source>` | Inspect a directory or Git repository |
| `plugin add [source]` | Install a complete native plugin |
| `plugin import [plugin@market] --from claude` | Adopt an existing native installation |
| `plugin inspect <name>` | Inspect a managed package |
| `plugin check [name]` | Check source changes without applying |
| `plugin update [name \| --all] --target claude` | Update a supported target from a reviewed source |
| `plugin enable [name] --target codex` | Select a target for the next sync |
| `plugin disable [name] --target codex` | Deselect a target for the next sync |
| `plugin remove [name]` | Uninstall managed bindings and remove definitions |
| `sync plugins [name]` | Apply plugin sync selection; alias for `plugin sync` |
Targets: Claude Code, Codex, Cursor, Antigravity (`agy`), Pi, and OpenCode.
Project mode supports Claude, Antigravity, Pi, and OpenCode.
Enable/disable only saves the selection. The next plugin sync installs selected
bindings or uninstalls deselected bindings while retaining their definitions.
Plugins are excluded from `sync --all`. Use `--dry-run --json` to preview mutations;
use `--no-tui` with explicit inputs for automation. See [plugin](../reference/commands/plugin.md)
for native client requirements and supported targets.
## Sync Operations
| Command | Description |
|---------|-------------|
| `sync extras` | Sync non-skill resources (rules, commands, etc.) |
| `sync mcp` | Sync MCP connection settings |
| `hooks list` | List managed native hooks |
| `sync hooks` | Sync native hooks without executing them |
| `sync --all` | Sync skills + agents + extras + MCP + hooks (excludes plugins) |
| `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 |
| `commit [-m "msg"]` | Create a local git commit without pushing |
| `push [-m "msg"] [--pull]` | Commit and push to git remote; `--pull` merges remote changes first, then syncs |
| `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 |
| `completion <shell> --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 <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
```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
# Editing on several machines: both ways in one command
skillshare push --pull -m "Update skills"
```
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
# Pin to a tag or commit SHA (regular install only)
skillshare install github.com/team/skills --branch v1.2.0 --all
# 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/<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
- [Commands Reference](/docs/reference/commands) — Full command documentation
- [Concepts](/docs/understand) — Core concepts explained