mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-20 12:23:22 +00:00
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)
2.5 KiB
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
doctorreports an available update
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
