Files
Willie adf6c9ecb3 feat(updates): allow opting out of automatic version checks (#847)
Add a global automatic-update preference with an environment override, CLI controls and dashboard settings. Suppress automatic release checks and cached notices while retaining explicit checks and upgrades.

Recheck policy before publishing in-flight results, preserve structured JSON errors, and reject incomplete manual checks. Include schema, completion, localization, documentation and regression coverage.

Closes #846.
2026-11-11 11:59:57 +08:00

6.9 KiB

sidebar_position
sidebar_position
1

Commands

Complete reference for all skillshare commands.

What do you want to do?

I want to... Command
Set up skillshare for the first time init
Manage project folders from the global config project
Install a skill from GitHub install
Create my own skill new
Sync skills to all AI CLIs sync
Check what's out of sync status / diff
Search for community skills search
Update installed skills check then update
Temporarily hide a skill without removing it enable / disable
Move installed skills into folders move
Save or sync changes with git commit / push / pull
Set up an MCP server once for every tool mcp
Manage native hooks across tools hooks
Manage complete plugins across supported tools plugin
Manage non-skill resources (rules, commands) extras
Manage single-file .md agents Most commands accept agents or --kind agent — see Agents
See which skills use the most context tokens analyze
Fix something broken doctor
Enable tab-completion in my shell completion
Open the web dashboard ui

Overview

Category Commands
Core init, install, uninstall, link, unlink, list, search, sync, status
Skill Management new, check, update, upgrade, enable, disable, move
MCP Connections mcp (add, edit, import, list, remove, restore), sync mcp
Hooks hooks (list, add, edit, import, enable, disable, remove, sync, restore)
Plugin Management plugin (list, discover, add, import, unimport, inspect, sync, check, update, enable, disable, remove)
Target Management target, project, diff
Extras Management extras (init, list, remove, collect)
Sync Operations collect, backup, restore, trash, commit, push, pull
Security & Utilities analyze, audit, hub, log, doctor, tui, ui, completion, version

Core Commands

Command Description
init First-time setup
install Add a skill from a repo or path
uninstall Remove a skill
link Link a folder of your own skills into the source
unlink Remove a link from the source
list List all skills
search Search for skills
sync Push skills to all targets
status Show sync state

Skill Management

Command Description
new Create a new skill
check Check for available updates
update Update a skill or tracked repo
updates Control automatic version checks and notifications
upgrade Upgrade CLI or built-in skill
enable / disable Temporarily enable or disable skills
move Move installed skills or folders without losing install records

Target Management

Command Description
target Manage targets
project Manage project folders and sync their skills and agents
diff Show differences between source and targets

Extras Management

Command Description
extras Manage non-skill resources (rules, commands, prompts)

MCP, Hooks and Plugins

Command Description
mcp Define MCP servers once and sync them into each tool's native config
hooks Manage native hook definitions, synchronization and recovery
plugin Install complete plugins and choose which tools receive them

Sync Operations

Command Description
collect Collect skills from target to source
backup Create backup of targets
restore Restore targets from backup
trash Manage uninstalled skills in trash
commit Create a local git commit without pushing
push Commit and push to git remote
pull Pull from git remote and sync

Security & Utilities

Command Description
analyze Analyze context window usage
audit Scan skills for security threats
log View operations and audit logs
doctor Diagnose issues
tui Toggle interactive TUI mode
ui Launch web dashboard
hub Manage skill hub sources
completion Generate shell completion scripts
version Show CLI version

Common Flags

Most commands support:

Flag Description
--dry-run, -n Preview without making changes
--help, -h Show help

Quick Reference

# Setup
skillshare init
skillshare init --remote git@github.com:you/skills.git

# Install skills
skillshare install anthropics/skills/skills/pdf
skillshare install github.com/team/skills --track

# Create skill
skillshare new my-skill

# Sync
skillshare sync
skillshare sync --dry-run

# Git checkpoints / cross-machine
skillshare commit -m "Update skill"
skillshare push -m "Add skill"
skillshare pull

# Status
skillshare status
skillshare list
skillshare diff

# Enable/disable skills
skillshare disable draft-*
skillshare enable draft-*

# Maintenance
skillshare update --all
skillshare analyze
skillshare audit
skillshare log
skillshare doctor
skillshare backup

# TUI preferences
skillshare tui            # Show current status
skillshare tui off        # Disable interactive TUI
skillshare tui on         # Re-enable TUI

# Web UI
skillshare ui
skillshare ui -p          # Project mode

# Hub
skillshare hub list
skillshare hub add https://hub.example.com/index.json

# Check for updates
skillshare check

# Trash management
skillshare trash list
skillshare trash restore my-skill

# Shell completion
skillshare completion bash --install
skillshare completion zsh --install

# Version
skillshare version