mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-19 02:17:09 +00:00
Init now creates an initial commit (including .gitignore) so that push/pull work immediately after setup. When a remote is configured, init fetches and auto-pulls existing skills from the remote. - Always create initial commit in doGitInit (fixes stale untracked .gitignore blocking pull) - Add ensureGitIdentity: set repo-local fallback when git user.name is not configured, with hint to set global config - Add tryPullAfterRemoteSetup: fetch remote after adding origin, auto-pull if remote has content and local is empty - Add hintGitRemoteError: context-aware hints for SSH, URL, and network errors in push/pull - Show Pro tip only when built-in skill is installed - Sandbox: add --bare mode (skip auto-init), --volumes for down (full reset), and sandbox-reset / sandbox:reset targets - Docs: update init flow diagram, cross-machine-sync guide, push/pull prerequisites, getting-started, troubleshooting
2.0 KiB
2.0 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
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:
- Creates your source directory (
~/.config/skillshare/skills/) - Auto-detects installed AI CLIs
- Sets up configuration
- Optionally installs the built-in skillshare skill (adds
/skillsharecommand 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"