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)
1.4 KiB
1.4 KiB
sidebar_position
| sidebar_position |
|---|
| 1 |
Troubleshooting
Having issues? Start here.
Quick Diagnosis
Run the doctor command:
skillshare doctor
This checks:
- Source directory
- Config file
- Target accessibility
- Symlink health
- Git status
What's happening?
| Problem | Go To |
|---|---|
| I see an error message | Common Errors |
| Something isn't working on Windows | Windows |
| I need a step-by-step debugging process | Troubleshooting Workflow |
| I have a general question | FAQ |
Quick Fixes
Skills not appearing
skillshare sync
Broken symlinks
skillshare sync --force
Config issues
skillshare doctor
Start fresh
rm ~/.config/skillshare/config.yaml
skillshare init
Getting Help
If you can't resolve the issue:
-
Gather information:
skillshare doctor skillshare status -
Search existing issues: GitHub Issues
-
Open a new issue with:
- Doctor output
- Error messages
- What you were trying to do
- Operating system
Related
- Troubleshooting Workflow — Step-by-step debugging
- Commands: doctor — Doctor command details