Files
skillshare/website/docs/learn/with-multiple-tools.md
T
Willie 2c3003e04f 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 04:52:29 +08:00

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

What's Next?