diff
显示 Source 与 Targets 之间的差异。
skillshare diff # 所有 Target（交互式 TUI）
skillshare diff claude # 指定 Target
skillshare diff agents # 仅 Agent Target
skillshare diff --stat # 文件级别的变更
skillshare diff --patch # 完整的统一 diff
skillshare diff --no-tui
claude, claude-work, gemini, opencode, universal
New remotion-captions
cursor
Local only cursor-shortcuts
New remotion-captions
Extras
✓ commands ~/.claude/commands · in sync
✓ rules ~/.claude/rules · in sync
✓ rules ~/.cursor/rules · in sync
✓ team ~/.codex · in sync
✓ team ~/.claude · in sync
✓ team ~/.gemini · in sync
✓ team ~/notes · in sync
! 6 targets: 6 to sync
Next
skillshare sync apply the changes
skillshare collect copy local-only skills into source
交互式 TUI
在 TTY 上，diff 会打开交互式界面：左侧是 targets，右侧是所选 target 的差异，可以一直看到文件级别的 diff。按键列在界面底部。使用 --no-tui 或将输出 pipe 出去，就会改为输出纯文本。
使用场景
- 在 sync 之前准确查看 Source 与某个 Target 之间的差异
- 查找仅存在于某个 Target 中的 Skill（仅本地存在，尚未 collect）
- 找出可以替换为 symlink 的本地副本
- 使用
--stat查看文件级变更，或使用--patch查看完整文本 diff
输出示例
claude
Local override local-copy
Local only my-local-skill
New another-skill, missing-skill
✓ cursor in sync
! 2 targets: 1 to sync, 1 in sync
Next
skillshare sync apply the changes
skillshare sync --force also replace local copies
skillshare collect copy local-only skills into source
分组显示多个 Target 的结果
当多个 Target 的 diff 结果完全相同时，会被归并到同一个区块中以减少噪音：
agents, claude
New skill-1, skill-2
cursor
New skill-1
✓ codex, copilot in sync
结果不同的 Target（例如由于 include/exclude filters）仍会分开显示。
标签说明
| Label | Meaning | Action |
|---|---|---|
| New | 存在于 Source，但 Target 中缺失 | sync 会添加它 |
| Restore | 曾存在于 Target 中，已被删除 | sync 会恢复它 |
| Modified | 内容已更改（copy mode） | sync 会更新它 |
| Local override | 本地副本而非 symlink | 使用 sync --force 替换 |
| Orphan | 存在于 manifest 中，但不在 Source 中 | sync 会清理它 |
| Local only | 仅存在于 Target 中，不在 Source 中 | 使用 collect 导入 |
文件级详情
--stat
显示每个 Skill 内哪些文件存在差异：
skillshare diff --stat
claude
Modified my-skill
+ new-file.md (120 bytes)
~ SKILL.md (840 → 912 bytes)
- old-file.md (64 bytes)
--patch
显示已修改文件的完整统一文本 diff：
skillshare diff --patch
claude
Modified my-skill
~ SKILL.md (840 → 912 bytes)
--- SKILL.md
- old line
+ new line
--stat 和 --patch 都隐含 --no-tui（纯文本输出）。
diff 显示的内容
Merge Mode 的 Target
对于使用 merge mode（默认）的 Target：
- 列出 Source 中尚未 symlink 到 Target 的 Skill
- 显示以本地副本形式存在（而非 symlink）的 Skill
- 识别 Target 中仅本地存在的 Skill（不在 Source 中 — sync 会保留它们）
Copy Mode 的 Target
对于使用 copy mode 的 Target：
- 列出 Source 中尚未被管理的 Skill（在 manifest 中缺失）
- 通过 checksum 比对显示内容变更
- 显示不再存在于 Source 中的孤立托管副本（sync 时会被清理）
- 识别仅本地存在的 Skill（既不在 Source 中，也未被管理）
Symlink Mode 的 Target
对于使用 symlink mode 的 Target：
- 仅检查 symlink 是否指向正确的 Source
- 显示 "in sync"，或对错误的 symlink 发出警告
使用案例
Sync 之前
查看将会发生哪些变更：
skillshare diff
# 查看 sync 将会执行的操作，然后：
skillshare sync
查找本地 Skill
发现你直接在某个 Target 中创建的 Skill：
skillshare diff claude
# 显示：Local only my-local-skill
skillshare collect claude # 导入到 Source
检查变更内容
在 sync 之前准确查看某个 Skill 发生了哪些变更：
skillshare diff --patch claude # 完整文本 diff
skillshare diff --stat claude # 文件级摘要
故障排查
当 sync 状态显示存在问题时：
skillshare status # 显示 "needs sync"
skillshare diff claude # 准确查看有哪些差异
skillshare sync # 修复问题
Agent Diff
使用 agents 关键字仅对 Agent Target 执行 diff：
skillshare diff agents # 所有支持 Agent 的 Target
skillshare diff agents claude # 指定 Target
skillshare diff agents --json # JSON 输出
Agent diff 会显示缺失的 Agent（需要 sync）、孤立的 symlink（需要 prune），以及仅本地存在的 Agent 文件。只有配置了 agents 路径的 Target 才会被包含在内。完整列表参见 Agents — Supported Targets。
选项
| Flag | Description |
|---|---|
--project, -p | 使用 Project mode |
--global, -g | 使用 Global mode |
--stat | 显示文件级变更（隐含 --no-tui） |
--patch | 显示完整的统一 diff（隐含 --no-tui） |
--no-tui | 纯文本输出（跳过交互式 TUI） |
--json | 输出为 JSON（隐含 --no-tui） |
JSON 输出
skillshare diff --json
{
"targets": [
{
"name": "claude",
"mode": "merge",
"synced": false,
"items": [
{"action": "link", "name": "missing-skill", "reason": "not in target", "is_sync": true},
{"action": "update", "name": "local-copy", "reason": "local override", "is_sync": true}
],
"include": [],
"exclude": []
}
],
"duration": "0.045s"
}