Files
skillshare/docs
Willie Hung 3de857b382 feat(update): support skills with metadata in --all
- `update --all` now updates both tracked repos and skills with
  .skillshare-meta.json
- Add spinner with progress indicator [1/7] for each item
- Safe update: install to temp dir first, then swap (prevents data
  loss on failure)
- Show warning (yellow) instead of error (red) for update failures
- Add Spinner.Warn() method for warning state
2026-01-30 09:43:04 +08:00
..
2026-01-29 13:46:50 +08:00
2026-01-29 13:46:50 +08:00
2026-01-28 23:20:42 +08:00

Skillshare Documentation

Welcome to the skillshare documentation. Choose a topic below.

I want to... Go to
Get started README
Create a new skill new.md
Install a skill install.md
Sync skills to targets sync.md
Manage targets targets.md
Sync across machines cross-machine.md
Share skills with team team-edition.md
Configure skillshare configuration.md
Troubleshoot issues faq.md

Documentation Structure

docs/
├── README.md          ← You are here
├── new.md             ← Create new skills from template
├── install.md         ← Install, update, upgrade, uninstall skills
├── sync.md            ← Sync, pull, push, backup, restore
├── targets.md         ← Add, remove, configure targets
├── cross-machine.md   ← Sync across multiple computers
├── team-edition.md    ← Tracked repos, nested skills, team sharing
├── configuration.md   ← Config file reference
└── faq.md             ← FAQ & troubleshooting

Command Quick Reference

Command What it does Docs
init First-time setup install.md
new Create a skill new.md
install Add a skill install.md
uninstall Remove a skill install.md
update Update a skill install.md
upgrade Upgrade CLI/skill install.md
sync Push to targets sync.md
pull Pull from target sync.md
push Push to git remote sync.md
backup Backup targets sync.md
restore Restore from backup sync.md
target Manage targets targets.md
list List skills install.md
status Show sync state sync.md
diff Show differences sync.md
doctor Diagnose issues faq.md

Core Concepts

Source vs Targets

┌─────────────────────────────────────────┐
│         SOURCE (edit here)              │
│   ~/.config/skillshare/skills/          │
│                                         │
│   my-skill/   another/   _team-repo/    │
└─────────────────────────────────────────┘
                    │
                    │ skillshare sync
                    ▼
┌─────────────────────────────────────────┐
│              TARGETS                    │
│   ~/.claude/skills/  (symlinks)         │
│   ~/.cursor/skills/  (symlinks)         │
│   ~/.codex/skills/   (symlinks)         │
└─────────────────────────────────────────┘
  • Source: Single directory where you edit skills
  • Targets: AI CLI skill directories (symlinked from source)
  • Sync: Creates/updates symlinks from source to targets

Sync Modes

Mode How it works
merge Each skill symlinked individually. Local skills preserved. (default)
symlink Entire directory is one symlink. All targets identical.

See sync.md for details.