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