Files
skillshare/website/docs/learn/with-copilot.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.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.

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 -p to 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

What's Next?