---

name: skillshare version: 0.5.0 description: Manages and syncs skills across AI CLI tools (Claude, Cursor, Codex) from a single source of truth. Use when asked to "sync my skills", "pull skills", "show skillshare status", "list my skills", "install a skill", or manage skill targets. argument-hint: "[command] [target] [--dry-run]"

Skillshare CLI

Syncs skills across multiple AI CLI tools from a single source of truth.

Quick Start

Copyskillshare status              # See current state (always run first)
skillshare sync                # Push skills to all targets
skillshare sync --dry-run      # Preview changes before sync
skillshare pull claude         # Bring new skills from target to source
skillshare list                # Show installed skills

AI Behavior Guide

Init Workflow

CRITICAL: AI cannot respond to CLI prompts. Use flags for non-interactive mode.

Init Checklist

Copy and track when initializing:

• Ask: "Do you have existing skills to copy?" → --copy-from <name> or --no-copy
• Ask: "Which CLI tools to sync?" → --targets <list>, --all-targets, or --no-targets
• Ask: "Initialize git?" → --git or --no-git
• Run: skillshare init [flags]
• Verify: skillshare status

Quick Defaults

If user just says "initialize skillshare":

Copyskillshare init --no-copy --all-targets --git

Examples

Copyskillshare init --copy-from claude --targets "claude,cursor" --git
skillshare init --no-copy --all-targets --git     # Fresh start
skillshare init --no-copy --no-targets --no-git   # Minimal

Core Commands

Symlink Safety

CRITICAL: In merge mode, editing a skill in ANY target edits the source.

• NEVER use rm -rf on symlinked skills - this deletes the source
• Use skillshare target remove <name> to safely unlink targets
• Use skillshare uninstall <name> to safely remove skills

Cross-Machine Workflow

Copy# Machine A: push changes
skillshare push -m "Add new skill"

# Machine B: pull and sync
skillshare pull --remote

Zero-Install Runner

If skillshare is not installed, run directly via curl:

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

See scripts/run.sh for the full runner script.

References

• status.md - status, diff, list, doctor
• sync.md - sync, pull, push
• install.md - install, uninstall
• targets.md - target management
• backup.md - backup, restore
• init.md - init flags reference
• TROUBLESHOOTING.md - Common issues and recovery