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)
2.4 KiB
sidebar_position
| sidebar_position |
|---|
| 2 |
Using skillshare with GitHub Copilot
From install to first sync — 5 minutes.
Prerequisites
- GitHub Copilot coding agent enabled in VS Code or JetBrains
- macOS, Linux, or Windows
Step 1: Install skillshare
curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh
Step 2: Initialize
skillshare init
This detects Copilot's skill directory (~/.copilot/skills/) and adds it as a target automatically.
Step 3: Switch to Copy Mode (Recommended)
We've received reports that Copilot sometimes fails to follow symlinks correctly. To avoid issues, switch the Copilot target to copy mode:
skillshare target copilot --mode copy
Copy mode physically copies skill files into ~/.copilot/skills/ instead of creating symlinks. The trade-off is that source edits aren't reflected instantly — you need to run skillshare sync to propagate changes. But it's more reliable across platforms.
:::tip When to use merge (symlink) mode If you're on macOS or Linux and Copilot reads symlinks correctly on your machine, the default merge mode works fine. You can always switch back:
skillshare target copilot --mode merge
:::
Step 4: Install Your First Skill
skillshare install runkids/my-skills
Step 5: Sync
skillshare sync
Skills are copied to ~/.copilot/skills/. Copilot picks them up as custom instructions.
Step 6: Verify
ls ~/.copilot/skills/
You should see your installed skills as real directories (in copy mode) or symlinks (in merge mode).
Copilot-Specific Notes
- Skill path:
~/.copilot/skills/(global) or.github/skills/(project) - Project mode: Run
skillshare init -pto manage project-level Copilot skills — they go into.github/skills/alongside your codebase - Symlink issues: If Copilot doesn't pick up your skills, check if your target is in merge mode (
skillshare status) and switch to copy mode as described above .github/copilot-instructions.md: If you have an existing instructions file, skillshare skills complement it — they don't replace it