Files
skillshare/docs
Willie 32014986ec fix(diff,sync): improve diff clarity and fix sync --force for merge mode
diff improvements:
- Use sync.DiscoverSourceSkills for proper tracked repo handling
- Remove "Diff:" prefix, show target name directly
- Clearer descriptions: "missing", "local copy (sync --force to replace)", "local only"
- Add action hints explaining what sync/pull commands will do

sync --force fix:
- Now properly replaces local copies with symlinks in merge mode
- Previously --force only worked for symlink mode conflicts

help improvements:
- Add GIT REMOTE section grouping push and pull --remote together
- Remove logo from status command (high-frequency operation)

docs: update sync.md with new diff output format and symbols table
2026-01-31 20:22:51 +08:00
..
2026-01-31 03:40:34 +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.