mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-19 02:17:09 +00:00
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)
111 lines
2.7 KiB
Markdown
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
|
|
```
|
|
|
|

|
|
|
|
## 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
|