Files
skillshare/website/docs/reference/commands/diff.md
T
Willie 2c3003e04f feat(website): complete website revamp — Diátaxis IA, blog, recipes, quickstarts
Restructure the entire documentation site following the Diátaxis framework
(Learn / How-to / Understand / Reference) with new content across 110 files.

## Information Architecture (M1)
- Move all docs to Diátaxis directory structure (learn/, how-to/, understand/, reference/)
- Add client-redirects plugin for old URL compatibility
- Rewrite sidebar, navbar, and footer to match new IA
- Update all internal cross-references

## Homepage + Quickstarts (M2)
- Add scenario entry cards to homepage with hand-drawn design
- 5 quickstart pages: Claude Code, GitHub Copilot (with copy mode recommendation),
  Codex, Multiple Tools, Dev Containers, Playground

## Blog + Changelog (M3)
- Enable Docusaurus blog plugin with authors.yml
- 5 blog posts: 5-min tutorial, managing 50+ skills, skillshare vs vercel/skills
  comparison, team sharing patterns, write your first skill
- Static /changelog page from CHANGELOG.md

## Recipes + Philosophy (M4)
- 5 recipe pages: CI/CD validation, enterprise skills, project setup,
  cross-machine sync, team onboarding
- 3 philosophy pages: why-local-first, security-first, sync-modes-explained

## Content Polish
- Cross-validate all content against CLI source (19 inaccuracies fixed)
- Lowercase "skillshare" throughout (avoid brand conflict with Skillshare Inc.)
- Add registry.yaml to file structure and Key Paths docs
- Highlight multi-platform git support (GitHub, GitLab, Bitbucket, Gitea,
  Azure DevOps, AtomGit, Codeberg)
- Standardize brew install command
- Add AsciinemaPlayer component (cast recordings pending)
2026-02-26 04:52:29 +08:00

111 lines
2.7 KiB
Markdown

---
sidebar_position: 2
---
# diff
Show differences between source and targets.
```bash
skillshare diff # All targets
skillshare diff claude # Specific target
```
![diff demo](/img/diff-demo.png)
## 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 orphan directories tracked by manifest (will be pruned on sync)
- Identifies local-only skills in target (not in manifest — preserved)
### 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:
```bash
skillshare diff
# See what sync will do, then:
skillshare sync
```
### Finding Local Skills
Discover skills you created directly in a target:
```bash
skillshare diff claude
# Shows: - my-local-skill local only
skillshare collect claude # Import to source
```
### Troubleshooting
When sync status shows issues:
```bash
skillshare status # Shows "needs sync"
skillshare diff claude # See exactly what's different
skillshare sync # Fix it
```
## Options
| Flag | Description |
|------|-------------|
| `--target, -t <name>` | Show diff for a specific target |
| `--project, -p` | Use project mode |
| `--global, -g` | Use global mode |
## See Also
- [sync](/docs/reference/commands/sync) — Sync to targets
- [collect](/docs/reference/commands/collect) — Import local skills
- [status](/docs/reference/commands/status) — Quick overview