runkids

skillshare

313
26
# Install this skill:
npx skills add runkids/skillshare

Or install specific skill: npx add-skill https://github.com/runkids/skillshare/tree/main/skills/skillshare

# Description

Syncs skills across AI CLI tools from a single source of truth. Use when asked to "sync skills", "collect skills", "pull from remote", "show status", "list skills", "install skill", "initialize skillshare", "search skills", or manage skill targets.

# SKILL.md


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


Skillshare CLI

Source: ~/.config/skillshare/skills  ← Single source of truth
         ↓ sync (symlinks)
Targets: ~/.claude/skills, ~/.cursor/skills, ...

Quick Start

skillshare status              # Check state
skillshare sync --dry-run      # Preview
skillshare sync                # Execute

Commands

Task Command
Status status, diff, list --verbose, doctor
Sync sync, sync --dry-run
Create new <name> β†’ sync
Search search <query>, search --list, search --json
Install install <source> β†’ sync
Team repo install <url> --track β†’ sync
Collect collect <target> β†’ sync
Update update <name>, update --all β†’ sync
Remove uninstall <name> β†’ sync
Git sync push -m "msg", pull
Targets target add <n> <p>, target remove <n>, target <n> --mode merge\|symlink
Upgrade upgrade, upgrade --cli, upgrade --skill

Init (Non-Interactive)

AI must use flags β€” cannot respond to CLI prompts.

# Step 1: Check existing skills
ls ~/.claude/skills ~/.cursor/skills 2>/dev/null | head -10

# Step 2: Run based on findings
skillshare init --copy-from claude --all-targets --git  # If skills exist
skillshare init --no-copy --all-targets --git           # Fresh start

# Step 3: Verify
skillshare status

Add new agents later:

skillshare init --discover --select "windsurf,kilocode"

See init.md for all flags.

Safety

NEVER rm -rf symlinked skills β€” deletes source. Use skillshare uninstall.

References

Topic File
Init flags init.md
Sync/pull/push sync.md
Install/update install.md
Status/diff/list status.md
Target management targets.md
Backup/restore backup.md
Troubleshooting TROUBLESHOOTING.md

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.