Files
skillshare/website/docs/getting-started/first-sync.md
T
Willie d30d90af76 feat: update Homebrew install to homebrew-core and detect missing UI
- Update Homebrew command from tap (runkids/tap/skillshare) to
  homebrew-core (brew install skillshare) in README, website homepage,
  and getting-started docs
- Add note that Homebrew build is CLI-only (no web dashboard)
- Add IsUIBuilt() detection in embed.go/embed_dev.go to check for
  placeholder UI at startup
- Show CLI warning with install instructions when skillshare ui is
  run on a build without the frontend
- Add Homebrew Note section to commands/ui.md with migration steps
2026-02-15 16:18:26 +08:00

2.3 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:

brew install skillshare

:::note Recommended for CLI-only users. The Homebrew build does not include the web dashboard — all other commands work identically. For the full experience including skillshare ui, use the curl installer below. :::

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

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)

:::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?