Files
skillshare/website/docs/getting-started/index.md
T
Willie 5da6c6cd59 docs: use Pi instead of Cursor in example tool lists
Example lists should name the tools users reach for today. Lists that
state real capability (agent-capable targets, copy-mode guidance) keep
Cursor because Pi has no agents path. The README also moves the demo
GIF up next to the intro.
2026-10-02 21:23:59 +08:00

2.5 KiB

sidebar_position
sidebar_position
1

Getting Started

skillshare keeps one source directory in sync with every AI CLI's skill directory on your machine. You write or install a skill once; symlinks make it appear in Claude, Pi, Codex, and any other configured target.

flowchart LR
    SRC["~/.config/skillshare/skills/<br/>(your Git repo)"]
    SRC --> CLAUDE["~/.claude/skills/"]
    SRC --> CURSOR["~/.cursor/skills/"]
    SRC --> CODEX["~/.agents/skills/"]

Source is a regular Git repo you own. Push from one machine, pull on another, share with a teammate — skillshare handles the symlink layer underneath.

What lives in source

Three kinds of skills coexist in your source directory. They differ only in how they're tracked by Git and how you update them.

Skills you author. Create with skillshare new <name> or just drop a folder in. Committed to your repo. Updated by editing.

Vendored skills. Installed with skillshare install <url>. The clone lives directly in your repo and gets committed alongside your own work. .metadata.json records the upstream URL so skillshare update can pull new versions later. Use this when you want to customize, freeze a version, or stay reproducible offline.

Tracked skills. Installed with skillshare install <url> --track. The clone lands in a _-prefixed directory that's auto-added to .gitignore, so it never enters your repo. skillshare update re-pulls it from upstream. Use this for company or community repos you don't intend to modify.

A typical source after a few months looks like:

~/.config/skillshare/skills/
├── my-review/                 # authored
├── my-deploy-checklist/       # authored
├── agent-browser/             # vendored
├── skill-creator/             # vendored
├── _company-skills/           # tracked  (gitignored)
└── _team-rules/               # tracked  (gitignored)

Pick a starting point

You are… Start here
Setting up skillshare for the first time First Sync
Have skills in Claude / Pi / Codex already From Existing Skills
Need command syntax fast Quick Reference
Want to poke around without installing Docker Playground

What's next