ReddRadar
Agent skill
skillshare
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.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/skillshare
SKILL.md
Skillshare CLI
Source: ~/.config/skillshare/skills ← Edit here (single source of truth)
↓ sync
Targets: ~/.claude/skills, ~/.cursor/skills, ... ← Symlinked from source
Quick Reference
skillshare 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
| Intent | Command |
|---|---|
| Sync skills | skillshare sync |
| Preview first | skillshare sync --dry-run then sync |
| Create new skill | skillshare new <name> then sync |
| Pull from target | skillshare pull <name> then sync |
| Install skill | skillshare install <source> then sync |
| Install from repo (browse) | skillshare install owner/repo (discovery mode) |
| Install team repo | skillshare install <git-url> --track then sync |
| Update skill/repo | skillshare update <name> then sync |
| Update all | skillshare update --all then sync |
| Remove skill | skillshare uninstall <name> then sync |
| List skills | skillshare list or list --verbose |
| Cross-machine push | skillshare push -m "message" |
| Cross-machine pull | skillshare pull --remote |
| Backup/restore | skillshare backup --list, restore <target> |
| Add custom target | skillshare target add <name> <path> |
| Change sync mode | skillshare target <name> --mode merge|symlink |
| Upgrade CLI/skill | skillshare upgrade |
| Diagnose issues | skillshare doctor |
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
ls ~/.claude/skills ~/.cursor/skills 2>/dev/null | head -10
Step 2: Run init based on findings
| Found | Command |
|---|---|
| Skills in one target | skillshare init --copy-from <name> --all-targets --git |
| Skills in multiple | Ask user which to import |
| No existing skills | skillshare init --no-copy --all-targets --git |
Step 3: skillshare status
Adding new agents later (AI must use --select):
skillshare 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
skillshare 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 -rfon symlinked skills — deletes source - Use
skillshare uninstall <name>to safely remove
Zero-Install
curl -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
Didn't find tool you were looking for?