Files
skillshare/website/docs/how-to/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

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