Files
skillshare/docs
Willie a739902ac2 feat!: rename pull <target> to collect, simplify pull for git-only
BREAKING CHANGE: Command restructure for clearer symmetry

- Local sync: sync/collect (Source ↔ Targets)
- Remote sync: push/pull (Source ↔ Git Remote)

Changes:
- Add `collect` command (was `pull <target>`)
- Simplify `pull` to git remote only (was `pull --remote`)
- Add spinner effects to pull and push commands
- Update all documentation and skill references
- Add CHANGELOG.md
- Update help examples with practical workflows

Migration:
  pull claude     → collect claude
  pull --all      → collect --all
  pull --remote   → pull
2026-01-31 20:52:09 +08:00
..
2026-01-29 13:46:50 +08:00

Skillshare Documentation

Welcome to the skillshare documentation. Choose a topic below.

I want to... Go to
Get started README
Search for skills search.md
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
├── search.md          ← Search and discover skills from GitHub
├── 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
search Discover skills search.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.