mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-19 02:17:09 +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)
1.8 KiB
1.8 KiB
sidebar_position
| sidebar_position |
|---|
| 4 |
Using skillshare with Multiple AI Tools
One source of truth, synced to every AI CLI you use.
The Problem
You use Claude Code at work, Cursor for side projects, and Codex for experiments. Each has its own skill directory. Keeping them in sync manually is tedious and error-prone.
The Solution
skillshare maintains a single source directory and syncs to all your targets with one command.
Step 1: Install and Initialize
curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh
skillshare init
init auto-detects all installed AI tools and adds them as targets.
Step 2: Check Your Targets
skillshare target list
Example output:
TARGET MODE PATH
claude merge ~/.claude/skills
cursor merge ~/.cursor/skills
codex merge ~/.codex/skills
opencode merge ~/.opencode/skills
Step 3: Install Skills
skillshare install runkids/my-skills
skillshare install anthropics/courses/prompt-eng
Step 4: Sync Everything
skillshare sync
One command pushes all skills to every target. Each target gets symlinks pointing back to your single source.
Step 5: Verify
skillshare status
Shows sync status across all targets — which skills are synced, missing, or out of date.
Per-Target Mode Control
Different tools have different needs. You can set sync mode per target:
# Cursor follows symlinks fine (default)
skillshare target cursor --mode merge
# Some tools need real files
skillshare target opencode --mode copy