Introduction

skillshare is a CLI tool that syncs AI CLI skills from a single source to all your AI coding assistants.

Why skillshare?

Install tools get skills onto agents. skillshare keeps them in sync.

	Install-once tools	skillshare
After install	Run update commands manually	Merge sync — per-skill symlinks, local skills preserved
Update a skill	Run update command / re-run install	Edit source, changes reflect instantly
Pull back edits	—	Bidirectional — collect from any agent
Cross-machine	Re-run install on each machine	git push/pull — one command sync
Local + installed	Managed separately	Unified in single source directory
Organization sharing	Commit skills.json or re-install	Tracked repos — git pull to update
Project skills	Copy skills per repo, diverge over time	Project mode — auto-detected, shared via git
Security audit	None	Built-in — auto-scan on install, audit command
AI integration	Manual CLI only	Built-in skill — AI operates directly

Quick Start

# Install
curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh

# Initialize (auto-detects CLIs, sets up git)
skillshare init

# Install a skill
skillshare install anthropics/skills/skills/pdf

# Sync to all targets
skillshare sync

Done. Your skills are now synced across all AI CLI tools.

Try without installing

Want to explore first? Use the Docker Playground — one command, no local install needed:

git clone https://github.com/runkids/skillshare.git && cd skillshare
make playground

How It Works

Edit in source → all targets update. Edit in target → changes go to source (via symlinks).

Key Features

• Auto-Detection — cd into a project with .skillshare/ and skillshare switches to project mode automatically
• Dual-Level Architecture — Organization skills for company standards + project skills for repo context
• Instant Updates — Symlink-based sync means edits reflect immediately across all AI tools
• Team Ready — Organization skills via tracked repos, project skills via git commit
• Any Git Host — Install, update, and check from GitHub, GitLab, Bitbucket, Azure DevOps, AtomGit, Gitee, or any self-hosted Git
• Security Audit — Scan skills for prompt injection, data exfiltration, and threats. Auto-scans on install

Supported Platforms

Platform	Source Path	Link Type
macOS/Linux	~/.config/skillshare/skills/	Symlinks
Windows	%AppData%\skillshare\skills\	NTFS Junctions

Next Steps

Individual Developer

1. First Sync — Get synced in 5 minutes
2. Creating Skills — Write your first skill
3. Cross-Machine Sync — Keep skills in sync across machines

Team Lead / Organization

1. Organization-Wide Skills — Share standards across the team
2. Project Setup — Set up project-scoped skills
3. Security Audit — Scan third-party skills before deployment

Already Have Skills?

• From Existing Skills — Migrate and consolidate

Explore More

• Core Concepts — Source, targets, sync modes
• Commands Reference — All available commands
• Docker Sandbox — Try skillshare in an isolated environment
• FAQ — Common questions