Files
skillshare/website/docs/getting-started/index.md
T
Willie 49a52498e9 docs: add current screenshots and diagrams to the guides
The dashboard screenshots predated the Projects page and showed codex at
its old path, and the guides for dashboard-only features (AGENTS.md
sharing, MCP, plugins, backups, hubs) had no pictures at all.

- Re-shoot the dashboard screenshots (docs and README copies) and add
  ones for targets, extras, shared AGENTS.md, MCP, project MCP, plugins,
  backups, hubs and project mode.
- Add diagrams for sharing AGENTS.md, MCP sync and migrating with
  collect; fix codex's path in the getting-started diagram.
- Replace terminal screenshots with real output as text, and remove
  images nothing referenced.
- Fix text that no longer matched the dashboard (project mode, hub
  navigation, backup list output).
2026-09-28 21:02:12 +08:00

2.6 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, Cursor, 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 / Cursor / Codex already From Existing Skills
Need command syntax fast Quick Reference
Want to poke around without installing Docker Playground

What's next