mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-20 12:23:22 +00:00
Add a third sync mode (`copy`) that copies skills as real files instead of symlinks, with a `.skillshare-manifest.json` tracking managed skills and SHA256 checksums for incremental updates. - Manifest-based tracking: skip unchanged, update modified, --force all - Pruning: remove managed copies no longer in source - Mode conversion: bidirectional merge↔copy and symlink↔copy - Full command support: sync, status, doctor, diff, target, collect - Server API + Web UI: targets list, drift detection, filter editing - include/exclude filters work in both merge and copy modes - 12 integration tests covering all acceptance criteria - Documentation updated across 13 pages Closes #31
2.4 KiB
2.4 KiB
sidebar_position
| sidebar_position |
|---|
| 2 |
diff
Show differences between source and targets.
skillshare diff # All targets
skillshare diff claude # Specific target
When to Use
- See exactly what's different between source and a target before syncing
- Find skills that exist only in a target (local-only, not yet collected)
- Identify local copies that could be replaced by symlinks
Example Output
claude
+ missing-skill missing
~ local-copy local copy (sync --force to replace)
- local-only local only
Run 'sync' to add missing, 'sync --force' to replace local copies
Run 'collect claude' to import local-only skills to source
Symbols
| Symbol | Meaning | Action |
|---|---|---|
+ |
In source, missing in target | sync will add it |
~ |
In both, but target has local copy (not symlink) | sync --force to replace |
- |
Only in target, not in source | collect to import |
What Diff Shows
Merge Mode Targets
For targets using merge mode (default):
- Lists skills in that target's expected set (after
include/exclude) not yet synced - Shows skills that exist as local copies instead of symlinks
- Identifies local-only skills in target
Copy Mode Targets
For targets using copy mode:
- Lists skills in source not yet managed (missing from manifest)
- Shows orphan managed copies no longer in source (will be pruned on sync)
- Identifies local-only skills (not in source and not managed)
Symlink Mode Targets
For targets using symlink mode:
- Simply checks if symlink points to correct source
- Shows "Fully synced" or warns about wrong symlink
Use Cases
Before Sync
Check what will change:
skillshare diff
# See what sync will do, then:
skillshare sync
Finding Local Skills
Discover skills you created directly in a target:
skillshare diff claude
# Shows: - my-local-skill local only
skillshare collect claude # Import to source
Troubleshooting
When sync status shows issues:
skillshare status # Shows "needs sync"
skillshare diff claude # See exactly what's different
skillshare sync # Fix it
