---

name: skillshare version: 0.6.4 description: Syncs skills across AI CLI tools from a single source of truth. Use when asked to "sync skills", "pull skills", "show status", "list skills", "install skill", "initialize skillshare", or manage skill targets. argument-hint: "[command] [target] [--dry-run]"

Skillshare CLI

CopySource: ~/.config/skillshare/skills  ← Edit here (single source of truth)
         ↓ sync
Targets: ~/.claude/skills, ~/.cursor/skills, ...  ← Symlinked from source

Quick Reference

Copyskillshare status              # Always run first
skillshare sync                # Push to all targets
skillshare sync --dry-run      # Preview changes
skillshare pull claude         # Import from target → source
skillshare list                # Show skills and tracked repos

Command Patterns

Init (Non-Interactive)

CRITICAL: Use flags — AI cannot respond to CLI prompts.

Source path: Always use default ~/.config/skillshare/skills. Only use --source if user explicitly requests a different location.

Step 1: Check existing skills

Copyls ~/.claude/skills ~/.cursor/skills 2>/dev/null | head -10

Step 2: Run init based on findings

Step 3: skillshare status

Adding new agents later (AI must use --select):

Copyskillshare init --discover --select "windsurf,kilocode"   # Non-interactive (AI use this)
# skillshare init --discover                              # Interactive only (NOT for AI)

See init.md for all flags.

Team Edition

Copyskillshare install github.com/team/skills --track   # Install as tracked repo
skillshare update _team-skills                       # Update later

Tracked repos: _ prefix, nested paths use __ (e.g., _team__frontend__ui).

Naming convention: Use {team}:{name} in SKILL.md to avoid collisions.

Safety

• NEVER rm -rf on symlinked skills — deletes source
• Use skillshare uninstall <name> to safely remove

Zero-Install

Copycurl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/skills/skillshare/scripts/run.sh | sh -s -- status

References

• init.md - Init flags
• sync.md - Sync, pull, push
• install.md - Install, update, uninstall
• status.md - Status, diff, list, doctor
• targets.md - Target management
• backup.md - Backup, restore
• TROUBLESHOOTING.md - Recovery