* feat(push): add --pull for two-way sync in one command
Users editing skills on several machines have to remember push on one and pull on the other, and a push from a machine that is behind fails until they pull first. push --pull commits local changes, merges the remote with the same merge semantics pull uses, pushes, and syncs the git root scope.
A conflict stops before anything is pushed and keeps the local commit; a target sync failure after a successful push is reported separately so the user knows the remote is already updated. It never rebases or force-pushes. commit rejects --pull instead of silently ignoring it, since both commands share the argument parser.
* docs(push): document push --pull across guides and translations
Cover the new flag on the push reference, the cross-machine sync guide, the quick reference, the daily workflow and the cross-machine recipe, in English and the ja, ko, zh-Hans and zh-Hant translations, plus the built-in skill's sync reference.
* fix(push): print the scope's sync command when --pull sync fails
A bare 'skillshare sync' retry hint defaults to skills and may pick project mode, so it does not redo an agents, extras, or root sync. Derive both the sync and the hint from one per-scope list.
* fix(pull): sync extras for the root git scope
The root scope versions skills, agents and extras, but pull and push --pull only synced skills and agents, so merged extras changes never reached their targets.
* fix(server): sync extras after a root-scope pull
The root scope versions extras too, but the dashboard pull only synced skills and agents, so merged extras never reached their targets. Matches the CLI fix.
* feat(ui): add a Sync both ways action to Git Sync
Mirrors skillshare push --pull: commit local changes, merge the remote and sync targets, then push, in one click. A pull conflict stops at the existing review before anything is pushed.
* feat(ui): confirm Sync both ways and list what it will do
Sync both ways commits, merges and pushes in one click, so ask first and show the concrete outcome (files to commit, remote commits to merge, scope, push target, conflict behavior) before changing anything.
* fix(ui): make Sync both ways match push --pull
It skipped target sync when the pull was already up to date, stopped on an empty remote instead of pushing, and the pull dropped extras warnings. Add alwaysSync and a remote_empty code to /api/pull and surface all extras warnings.
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] --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
for native client requirements and supported targets.
# 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
make playground # start + enter shell
skillshare --help
ss status
exit# leave shell
make playground-down # stop container