mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-20 20:34:19 +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)
44 lines
1.4 KiB
Markdown
44 lines
1.4 KiB
Markdown
---
|
|
sidebar_position: 1
|
|
---
|
|
|
|
# Getting Started
|
|
|
|
Get skillshare running in minutes. Choose your starting point:
|
|
|
|
## What's your situation?
|
|
|
|
| I want to... | Start here |
|
|
|--------------|-----------|
|
|
| Set up skillshare from scratch | [First Sync](./first-sync.md) — install, init, and sync in 5 minutes |
|
|
| I already have skills in Claude/Cursor/etc. | [From Existing Skills](./from-existing-skills.md) — consolidate and unify |
|
|
| I know skillshare, just need command syntax | [Quick Reference](./quick-reference.md) — cheat sheet |
|
|
| Try without installing anything | [Docker Playground](/docs/how-to/advanced/docker-sandbox#playground) — `make playground` in cloned repo |
|
|
|
|
## The 3-Step Pattern
|
|
|
|
No matter which path you choose, skillshare follows a simple pattern:
|
|
|
|
```bash
|
|
# 1. Install skillshare
|
|
curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh
|
|
|
|
# 2. Initialize (auto-detects your AI CLIs)
|
|
skillshare init
|
|
|
|
# 3. Sync skills to all targets
|
|
skillshare sync
|
|
```
|
|
|
|
After setup, behavior depends on mode:
|
|
- `merge`/`symlink`: source edits reflect immediately
|
|
- `copy`: changes apply on next `sync`
|
|
|
|
## What's Next?
|
|
|
|
After you're set up:
|
|
|
|
- [Core Concepts](/docs/understand) — Understand source, targets, and sync modes
|
|
- [Daily Workflow](/docs/how-to/daily-tasks/daily-workflow) — How to use skillshare day-to-day
|
|
- [Commands Reference](/docs/reference/commands) — Full command reference
|