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
|
|
---
|
|
|
|
# Appendix
|
|
|
|
Technical reference appendix for skillshare.
|
|
|
|
## What are you looking for?
|
|
|
|
| Topic | Read |
|
|
|-------|------|
|
|
| Environment variables that affect skillshare | [Environment Variables](/docs/reference/appendix/environment-variables) |
|
|
| Where skillshare stores config, skills, logs, cache | [File Structure](/docs/reference/appendix/file-structure) |
|
|
| Supported git URL formats | [URL Formats](/docs/reference/appendix/url-formats) |
|
|
| Config file format and options | [Configuration](/docs/reference/targets/configuration) |
|
|
| All CLI commands | [Commands](/docs/reference/commands) |
|
|
|
|
## Quick Reference
|
|
|
|
### Key Paths (Unix)
|
|
|
|
| Path | Purpose |
|
|
|------|---------|
|
|
| `~/.config/skillshare/config.yaml` | Configuration file |
|
|
| `~/.config/skillshare/registry.yaml` | Installed skill registry (auto-managed) |
|
|
| `~/.config/skillshare/skills/` | Source directory (your skills) |
|
|
| `~/.local/share/skillshare/backups/` | Backup directory |
|
|
| `~/.local/share/skillshare/trash/` | Soft-deleted skills |
|
|
| `~/.local/state/skillshare/logs/` | Operation and audit logs |
|
|
| `~/.cache/skillshare/ui/` | Downloaded web dashboard |
|
|
|
|
### Environment Variables
|
|
|
|
| Variable | Purpose |
|
|
|----------|---------|
|
|
| `SKILLSHARE_CONFIG` | Override config path |
|
|
| `GITHUB_TOKEN` | GitHub API authentication |
|
|
|
|
## See Also
|
|
|
|
- [Configuration](/docs/reference/targets/configuration) — Config file details
|
|
- [Commands](/docs/reference/commands) — All commands
|