Willie 95ca07be89 feat: add target info/mode commands, show mode in status/doctor
- Add `skillshare target <name>` to show target details
- Add `skillshare target <name> --mode <mode>` to change target mode
- Show sync mode [merge/symlink] in status and doctor output
- Show warning when configured mode doesn't match actual state
- Fix sync to properly convert between symlink and merge modes
- Simplify module name to `skillshare`
- Remove go install option from README (incompatible with simplified module)
2026-01-14 20:43:00 +08:00
2026-01-14 18:09:36 +08:00
2026-01-14 18:09:36 +08:00
2026-01-14 18:09:36 +08:00

skillshare

Share skills across AI CLI tools (Claude Code, Codex CLI, Cursor, Gemini CLI, OpenCode).

The Problem

Each AI CLI tool has its own skills directory:

~/.claude/skills/
~/.codex/skills/
~/.cursor/skills/
~/.gemini/antigravity/skills/
~/.config/opencode/skills/

Keeping them in sync manually is tedious.

The Solution

skillshare maintains a single source directory and symlinks skills to all CLI tools:

~/.config/skillshare/
    ├── config.yaml
    └── skills/           <- Your shared skills live here
        ├── my-skill/
        └── another-skill/

~/.claude/skills/
    ├── my-skill     -> ~/.config/skillshare/skills/my-skill (symlink)
    ├── another-skill -> ~/.config/skillshare/skills/another-skill (symlink)
    └── local-only/   <- Local skills are preserved

Installation

macOS

# Apple Silicon (M1/M2/M3/M4)
curl -sL https://github.com/runkids/skillshare/releases/latest/download/skillshare_0.1.0_darwin_arm64.tar.gz | tar xz
sudo mv skillshare /usr/local/bin/

# Intel
curl -sL https://github.com/runkids/skillshare/releases/latest/download/skillshare_0.1.0_darwin_amd64.tar.gz | tar xz
sudo mv skillshare /usr/local/bin/

Linux

# x86_64
curl -sL https://github.com/runkids/skillshare/releases/latest/download/skillshare_0.1.0_linux_amd64.tar.gz | tar xz
sudo mv skillshare /usr/local/bin/

# ARM64
curl -sL https://github.com/runkids/skillshare/releases/latest/download/skillshare_0.1.0_linux_arm64.tar.gz | tar xz
sudo mv skillshare /usr/local/bin/

Windows

Download from Releases and add to PATH.

Homebrew (macOS/Linux)

brew install runkids/tap/skillshare

Verify Installation

skillshare version

Uninstall

# Homebrew
brew uninstall skillshare

# Manual (curl install)
sudo rm /usr/local/bin/skillshare

# Config and data (optional)
rm -rf ~/.config/skillshare

Quick Start

# 1. Initialize with default source directory (~/.skills)
skillshare init

# 2. Check detected targets
skillshare status

# 3. Sync (migrate existing skills + create symlinks)
skillshare sync

Usage

Initialize

# Use default source (~/.skills)
skillshare init

# Or specify custom source
skillshare init --source ~/my-skills

This will:

  • Create the source directory
  • Detect installed CLI tools
  • Create config at ~/.config/skillshare/config.yaml

Sync

# Preview what will happen
skillshare sync --dry-run

# Actually sync
skillshare sync

On first sync, existing skills are migrated to the source directory, then symlinks are created.

Status

skillshare status

Shows:

  • Source directory and skill count
  • Each target's status (linked, has files, not exist, conflict)

Manage Targets

# List targets
skillshare target list

# Add custom target
skillshare target add myapp ~/.myapp/skills

# Unlink target (restore skills and remove from config)
skillshare target remove myapp

# Unlink all targets
skillshare target remove --all

Configuration

Config file: ~/.config/skillshare/config.yaml

source: ~/.config/skillshare/skills
mode: merge   # default mode for all targets
targets:
  claude:
    path: ~/.claude/skills
    mode: symlink   # override: use full directory symlink
  codex:
    path: ~/.codex/skills
  cursor:
    path: ~/.cursor/skills
  gemini:
    path: ~/.gemini/antigravity/skills
  opencode:
    path: ~/.config/opencode/skills
ignore:
  - "**/.DS_Store"
  - "**/.git/**"

Sync Modes

Mode Behavior
merge (default) Each skill is symlinked individually. Local skills in target are preserved.
symlink Entire directory becomes a symlink to source. All targets share the same skills.

Use symlink mode when you want all targets to share exactly the same skills.

How It Works

  1. init: Detects CLI tools, optionally copy from existing skills
  2. sync:
    • Backup targets with local skills before sync
    • Create symlinks (merge mode: per-skill, symlink mode: whole directory)
  3. status: Check symlink health
  4. target remove: Backup, unlink symlinks, restore skills

Backups

Automatic backups are created before sync and target remove operations.

Location: ~/.config/skillshare/backups/<timestamp>/<target>/

License

MIT

Languages
Go 73.7%
TypeScript 20.2%
JavaScript 3%
Shell 1.4%
CSS 0.9%
Other 0.7%