Files
skillshare/website/docs/getting-started/first-sync.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

4.6 KiB

sidebar_position
sidebar_position
2

First Sync

Get your skills synced in 5 minutes.

Prerequisites

  • macOS, Linux, or Windows
  • At least one AI CLI installed (Claude Code, Cursor, Codex, etc.)

Step 1: Install skillshare

Homebrew (macOS / Linux):

brew install skillshare

:::note Homebrew releases may lag behind the latest version by a few days. For the newest release, use the install script below. :::

:::note All install methods include the web dashboard. skillshare ui automatically downloads UI assets on first launch — no extra setup needed. :::

:::tip Updating To update to the latest version, run skillshare upgrade. It auto-detects your install method (Homebrew, manual, etc.) and handles the rest. :::

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh

Windows (PowerShell):

irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex

Step 2: Initialize

skillshare init

Interactive init flow

This:

  1. Creates your source directory (~/.config/skillshare/skills/)
  2. Auto-detects installed AI CLIs
  3. Sets up configuration
  4. Optionally installs the built-in skillshare skill (adds /skillshare command to AI CLIs)

Init mode tip

init supports --mode to set your starting sync behavior:

skillshare init --mode copy
  • merge (default): per-skill links, local target skills preserved
  • copy: real files, compatibility-first
  • symlink: whole target dir linked

If you later run discover with mode:

skillshare init --discover --select cursor --mode copy

--mode is applied only to targets added in that discover run. Existing targets are not modified.

:::tip Built-in Skill During init, you'll be prompted: Install built-in skillshare skill? [y/N]. This adds a skill that lets your AI CLI manage skillshare directly. You can skip it and install later with skillshare upgrade --skill. :::

With git remote (recommended for cross-machine sync):

skillshare init --remote git@github.com:you/my-skills.git

If the remote already has skills (e.g., from another machine), they'll be pulled automatically during init.


Step 3: Install your first skill

# Browse available skills
skillshare install anthropics/skills

# Or install directly
skillshare install anthropics/skills/skills/pdf

Skills are automatically scanned for security threats during install. If critical issues are found, the install is blocked — use --force to override.


Step 4: Sync to all targets

skillshare sync

Your skill is now available in all your AI CLIs.


Verify

skillshare status

You should see:

  • Source directory with your skill
  • Targets (Claude, Cursor, etc.) showing "synced"

What's Next?

What Just Happened?

Here's what skillshare did behind the scenes:

  1. init — Created ~/.config/skillshare/config.yaml and ~/.config/skillshare/skills/. Auto-detected your AI CLIs (Claude, Cursor, etc.) and added them as targets.

  2. install — Cloned the skill from the Git repository into your source directory (~/.config/skillshare/skills/). Ran a security audit automatically. Works with GitHub, GitLab, Bitbucket, Gitea, Azure DevOps, and any HTTPS/SSH Git host.

  3. sync — Applied each target's configured sync mode (default is merge, which creates per-skill symlinks). For example:

    ~/.claude/skills/pdf → ~/.config/skillshare/skills/pdf  (symlink)
    

This means:

  • Mode-aware behavior — Merge/symlink modes reflect source edits immediately; copy mode updates on next sync
  • Non-destructive — Existing target-local skills are preserved in merge/copy mode
  • Reversible — skillshare backup creates snapshots; skillshare restore reverts

Need a different behavior for one target? Use per-target overrides:

skillshare target <name> --mode copy
skillshare sync

See Sync Modes for the decision matrix and trade-offs.

See Also