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)
3.9 KiB
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
Related
- Quick Reference — Command cheat sheet
- Workflows — Common usage patterns