SkillBox 是一个基于 Tauri 的桌面工具，用来统一扫描、整理、链接和同步多个 AI 应用里的技能目录。
如果 macOS 提示“SkillBox 已损坏，无法打开”，通常是系统的安全隔离校验拦截了应用，不一定是真的文件损坏。确认安装包来源可信后，可以执行下面的命令移除隔离标记：
xattr -dr com.apple.quarantine /Applications/SkillBox.app如果你没有把应用拖到“应用程序”目录，请把命令里的 /Applications/SkillBox.app 改成你本机实际的 SkillBox.app 路径，然后重新打开应用。
- 扫描常见 AI 应用的技能目录，并识别应用是否已安装、是否已链接
- 支持添加自定义扫描路径，纳入统一管理
- 聚合多个应用中的 skills 到一个本地同步目录
- 检测重复项和内容冲突，查看技能来源
- 支持技能重命名、删除、打开所在目录
- 支持为应用创建或取消软链接
- 支持为每个应用单独启用或禁用同步目录中的技能
- 技能市场在未安装
skills/npx时，也可自动切换到内置网络模式进行搜索、查看说明和安装 - 提供 Git 仓库地址、用户名、分支配置，以及推送、拉取、同步操作
- 支持浅色、深色和跟随系统主题
- 在设置页选择一个"技能存储目录"，作为本地统一同步目录
- 回到首页扫描应用，查看已发现的技能来源
- 如果某些应用不在预设列表中，可以添加自定义路径
- 使用"汇总技能"把各应用中的 skills 整理到本地同步目录
- 配置 Git 仓库地址、用户名和分支后，执行推送、拉取或同步
- 根据需要为支持的应用创建或取消软链接
说明：从当前版本开始，本地同步目录主要作为 SkillBox 的工作区使用；Git 操作会在该目录下的隐藏子目录 .skillbox-git 中执行，再与工作区做受控同步，避免“汇总技能”和 Git 拉取/合并直接在同一目录里互相冲突。
| 应用 | 默认路径 |
|---|---|
| Claude Code | ~/.claude/commands |
| Cursor | ~/.cursor/rules |
| Windsurf | ~/.windsurf/rules |
| Codex | ~/.codex/skills |
| GitHub Copilot | ~/.copilot/skills |
| opencode | ~/.config/opencode/skills |
软链接功能会把应用的技能目录指向 SkillBox 托管目录，再由托管目录按技能逐个软连接到统一同步目录，实现一处同步、按应用精细控制。
创建软链接：点击应用卡片上的"创建链接"按钮，应用原目录会先备份，再替换为指向托管目录的软链接。首次创建时默认启用同步目录中的全部技能。
管理启用技能：应用已经链接后，可以在应用卡片中打开"管理启用技能"，按应用勾选该应用可见的技能。保存后只会影响当前应用。
配置同步：每个应用的技能启用状态会写入同步目录下的 .skillbox-enabled-skills.json，因此也会跟随 Git 一起推送和拉取。拉取到新的配置后，SkillBox 会按该文件自动重建各应用的启用状态。
技能锁文件：同步目录下会生成 skills-lock.json，用于记录每个已汇总技能的来源信息（来源应用、来源路径）以及内容指纹（如 contentHash、canonicalName、fileCount），便于跨设备复现和排查来源。该文件会跟随 Git 一起推送和拉取。
取消软链接：点击"取消链接"会删除软链接并恢复原始目录结构，原有技能目录备份会被还原。
兼容旧链接：如果之前已经是“整目录直连”的旧模式，首次保存技能开关时会自动迁移到新的按技能启用模式。
GitHub Copilot 说明：Copilot 的技能目录使用 ~/.copilot/skills，每个技能都需要独立目录和 SKILL.md。根据 GitHub 当前文档，agent skills 目前用于 Copilot coding agent、GitHub Copilot CLI，以及 VS Code Insiders 的 agent mode；稳定版 VS Code 支持仍在逐步补齐。