Files
skillshare/website/docs/reference/commands/upgrade.md
T
Willie 2c3003e04f 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 04:52:29 +08:00

2.5 KiB

sidebar_position
sidebar_position
3

upgrade

Upgrade the skillshare CLI binary and/or the built-in skillshare skill.

skillshare upgrade              # Upgrade both CLI and skill
skillshare upgrade --cli        # CLI only
skillshare upgrade --skill      # Skill only

When to Use

  • A new version of the skillshare CLI is available
  • The built-in skillshare skill needs updating
  • After doctor reports an available update

upgrade demo

What Happens

flowchart TD
    TITLE["skillshare upgrade"]
    CLI["1. Upgrade CLI binary"]
    SKILL["2. Upgrade built-in skill"]
    TITLE --> CLI --> SKILL

Options

Flag Description
--cli Upgrade CLI only
--skill Upgrade skill only (prompts if not installed)
--force, -f Skip confirmation prompts
--dry-run, -n Preview without making changes
--help, -h Show help

Homebrew Users

If you installed via Homebrew, skillshare upgrade automatically delegates to brew upgrade:

skillshare upgrade
# → brew update && brew upgrade skillshare

You can also use Homebrew directly:

brew upgrade skillshare

Examples

# Standard upgrade (both CLI and skill)
skillshare upgrade

# Preview what would be upgraded
skillshare upgrade --dry-run

# Force upgrade without prompts
skillshare upgrade --force

# Upgrade only the CLI binary
skillshare upgrade --cli

# Upgrade only the skillshare skill
skillshare upgrade --skill

After Upgrading

If you upgraded the skill, run skillshare sync to distribute it:

skillshare upgrade --skill
skillshare sync  # Distribute to all targets

What Gets Upgraded

CLI Binary

The skillshare executable itself. Downloads from GitHub releases.

Web UI Assets

After upgrading, skillshare pre-downloads the Web UI frontend assets for the new version. These are cached at ~/.cache/skillshare/ui/<version>/ and served when you run skillshare ui.

If the pre-download fails (e.g. network issues), the assets will be downloaded on the next skillshare ui launch instead.

skillshare Skill

The built-in skillshare skill that adds the /skillshare command to AI CLIs. Located at:

~/.config/skillshare/skills/skillshare/SKILL.md

See Also

  • update — Update other skills and repos
  • status — Check current versions
  • doctor — Diagnose issues