Files
skillshare/website/docs/reference/commands/index.md
T
Willie caa525b8aa feat(website): complete website revamp — Diátaxis IA, blog, recipes, quickstarts
Restructure the entire documentation site following the Diátaxis framework
(Learn / How-to / Understand / Reference) with new content across 110 files.

## Information Architecture (M1)
- Move all docs to Diátaxis directory structure (learn/, how-to/, understand/, reference/)
- Add client-redirects plugin for old URL compatibility
- Rewrite sidebar, navbar, and footer to match new IA
- Update all internal cross-references

## Homepage + Quickstarts (M2)
- Add scenario entry cards to homepage with hand-drawn design
- 5 quickstart pages: Claude Code, GitHub Copilot (with copy mode recommendation),
  Codex, Multiple Tools, Dev Containers, Playground

## Blog + Changelog (M3)
- Enable Docusaurus blog plugin with authors.yml
- 5 blog posts: 5-min tutorial, managing 50+ skills, skillshare vs vercel/skills
  comparison, team sharing patterns, write your first skill
- Static /changelog page from CHANGELOG.md

## Recipes + Philosophy (M4)
- 5 recipe pages: CI/CD validation, enterprise skills, project setup,
  cross-machine sync, team onboarding
- 3 philosophy pages: why-local-first, security-first, sync-modes-explained

## Content Polish
- Cross-validate all content against CLI source (19 inaccuracies fixed)
- Lowercase "skillshare" throughout (avoid brand conflict with Skillshare Inc.)
- Add registry.yaml to file structure and Key Paths docs
- Highlight multi-platform git support (GitHub, GitLab, Bitbucket, Gitea,
  Azure DevOps, AtomGit, Codeberg)
- Standardize brew install command
- Add AsciinemaPlayer component (cast recordings pending)
2026-02-26 22:27:23 +08:00

3.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
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
Sync across machines push / pull
Fix something broken doctor
Open the web dashboard ui

Overview

Category Commands
Core init, install, uninstall, list, search, sync, status
Skill Management new, check, update, upgrade
Target Management target, diff
Sync Operations collect, backup, restore, trash, push, pull
Security & Utilities audit, hub, log, doctor, ui, version

Core Commands

Command Description
init First-time setup
install Add a skill from a repo or path
uninstall Remove a skill
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
upgrade Upgrade CLI or built-in skill

Target Management

Command Description
target Manage targets
diff Show differences between source and targets

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
push Push to git remote
pull Pull from git remote and sync

Security & Utilities

Command Description
audit Scan skills for security threats
log View operations and audit logs
doctor Diagnose issues
ui Launch web dashboard
hub Manage skill hub sources
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

# Cross-machine
skillshare push -m "Add skill"
skillshare pull

# Status
skillshare status
skillshare list
skillshare diff

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

# 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

# Version
skillshare version