mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-19 02:17:09 +00:00
Restructure the entire documentation site following the Diátaxis framework (Learn / How-to / Understand / Reference) with new content across 110 files. ## Information Architecture (M1) - Move all docs to Diátaxis directory structure (learn/, how-to/, understand/, reference/) - Add client-redirects plugin for old URL compatibility - Rewrite sidebar, navbar, and footer to match new IA - Update all internal cross-references ## Homepage + Quickstarts (M2) - Add scenario entry cards to homepage with hand-drawn design - 5 quickstart pages: Claude Code, GitHub Copilot (with copy mode recommendation), Codex, Multiple Tools, Dev Containers, Playground ## Blog + Changelog (M3) - Enable Docusaurus blog plugin with authors.yml - 5 blog posts: 5-min tutorial, managing 50+ skills, skillshare vs vercel/skills comparison, team sharing patterns, write your first skill - Static /changelog page from CHANGELOG.md ## Recipes + Philosophy (M4) - 5 recipe pages: CI/CD validation, enterprise skills, project setup, cross-machine sync, team onboarding - 3 philosophy pages: why-local-first, security-first, sync-modes-explained ## Content Polish - Cross-validate all content against CLI source (19 inaccuracies fixed) - Lowercase "skillshare" throughout (avoid brand conflict with Skillshare Inc.) - Add registry.yaml to file structure and Key Paths docs - Highlight multi-platform git support (GitHub, GitLab, Bitbucket, Gitea, Azure DevOps, AtomGit, Codeberg) - Standardize brew install command - Add AsciinemaPlayer component (cast recordings pending)
4.0 KiB
4.0 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
- 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
- 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