mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-19 02:17:09 +00:00
The docs said Windows always links with NTFS junctions and needs no admin rights, which is only true for folders. Explain that single files need Developer Mode for symlinks and otherwise sync as tracked copies, with the warning line users will see and the folder-icon symptom from the issue. Cover the per-target mode picker, the restore preview, changing a target's file location, the single-column file tab with edit/preview, universal's file list, and switching back to import. Also correct status and doctor output that no longer matched the code, and the doctor "Link not supported" advice, which pointed at Developer Mode although that check creates a folder junction. Refs #299
4.2 KiB
4.2 KiB
sidebar_position, slug
| sidebar_position | slug |
|---|---|
| 1 | / |
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.
:::tip[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
flowchart LR
subgraph ORG["ORGANIZATION"]
ORG_SRC["~/.config/skillshare/skills/"] -- sync --> ORG_TGT["~/.claude/skills/ etc."]
end
subgraph PROJ["PROJECT"]
PROJ_SRC[".skillshare/skills/"] -- sync --> PROJ_TGT[".claude/skills/ etc."]
end
Edit in source → all targets update. Edit in target → changes go to source (via symlinks).
Key Features
- Auto-Detection —
cdinto 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 for folders; symlinks for single files (Developer Mode, otherwise copies) |
Next Steps
Individual Developer
- First Sync — Get synced in 5 minutes
- Creating Skills — Write your first skill
- Cross-Machine Sync — Keep skills in sync across machines
Team Lead / Organization
- Organization-Wide Skills — Share standards across the team
- Project Setup — Set up project-scoped skills
- 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