mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-19 02:17:09 +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.8 KiB
2.8 KiB
sidebar_position
| sidebar_position |
|---|
| 1 |
How-To Guides
Practical guides for specific tasks and use cases.
What do you want to do?
| I want to... | Read |
|---|---|
| Write my first skill | Creating Skills |
| Design reliable, deterministic skills | Skill Design |
| Organize a growing skill collection | Organizing Skills |
| Share skills with my team via a git repo | Organization-Wide Skills |
| Set up skills for a specific project | Project Setup |
| Sync skills across multiple machines | Cross-Machine Sync |
| Browse and discover community skills | Hub Index |
| Secure my skill supply chain | Securing Your Skills |
| Move from another tool or approach | Migration |
| Test skillshare in an isolated Docker sandbox | Docker Sandbox |
By Topic
Daily Tasks
| Guide | Description |
|---|---|
| Creating Skills | Create and publish your own skills |
| Organizing Skills | Organize skills into folders with auto-flattening |
| Best Practices | Naming, organization, and versioning |
| Daily Workflow | Day-to-day skill management workflow |
| Skill Discovery | Find and evaluate skills |
| Backup & Restore | Back up and restore your skills |
| Project Workflow | Project-level skill workflow |
Sharing & Teams
| Guide | Description |
|---|---|
| Project Setup | Set up project-scoped skills for a repo |
| Organization-Wide Skills | Share skills across your organization |
| Cross-Machine Sync | Sync skills across computers |
| Hub Index | Browse and manage skill hubs |
Advanced
| Guide | Description |
|---|---|
| Migration | Migrate from other tools or between modes |
| Local-First | Local-first architecture details |
| Docker Sandbox | Isolated test sandbox and interactive playground |
| Securing Your Skills | Security scanning, custom rules, and organizational policy |