Files
skillshare/website/docs/intro.md
T
Willie f16a28d678 docs: restructure website documentation with scenario-driven navigation
- Add version command page and fix commands index (missing check, trash, hub)
- Document target aliases and XDG base directory layout
- Rewrite all 9 section index pages with "What do you want to do?" tables
- Standardize all 24 command docs with "When to Use" and "See Also" sections
- Enhance intro with role-based paths (individual / team / migration)
- Add "What Just Happened?" explainer to first-sync getting-started page
- Add practical context callouts (:::tip) to all concept pages
- Add See Also cross-references to all guide and workflow pages

59 files changed, 547 insertions(+), 163 deletions(-)
2026-02-16 17:01:06 +08:00

4.5 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.

How It Works

┌─────────────────────────────────────────────────────────────┐
│                    DUAL-LEVEL ARCHITECTURE                  │
│                                                             │
│  ORGANIZATION LEVEL              PROJECT LEVEL              │
│  ~/.config/skillshare/           .skillshare/skills/        │
│  ├── my-skill/                   ├── api-conventions/       │
│  └── _company-std/               └── deploy-guide/          │
│         │                               │                   │
│         ▼ sync                          ▼ sync              │
│  ~/.claude/skills/               .claude/skills/            │
│  (system-wide targets)           (project-local targets)    │
│                                  ← auto-detected by cd      │
└─────────────────────────────────────────────────────────────┘

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
  • 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?

Explore More