Files
skillshare/website/docs/reference/appendix/index.md
T
Willie caa525b8aa feat(website): complete website revamp — Diátaxis IA, blog, recipes, quickstarts
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)
2026-02-26 22:27:23 +08:00

1.4 KiB

sidebar_position
sidebar_position
1

Appendix

Technical reference appendix for skillshare.

What are you looking for?

Topic Read
Environment variables that affect skillshare Environment Variables
Where skillshare stores config, skills, logs, cache File Structure
Supported git URL formats URL Formats
Config file format and options Configuration
All CLI commands 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