Skills Manager（技能管理器）
把 AI Agent 技能写入一次，通过符号链接同步到 32 个 AI 编码工具的本地优先桌面管理器。
技能本身仅驱动本地 CLI：无网络调用、无凭据读取，操作范围限于 ~/.skills-manager 与各工具技能目录的符号链接；写入命令有 advisory lock，Windows 回退链（symlink→junction→tracked copy）透明记录来源。扣分点：`adopt` 会移动用户真实目录，且 `--` 不带 `--yes` 也会跳过确认直接应用（文档自己承认），对代理调用者存在误触发即产生变更的风险；二进制需从网站或 Releases 下载，未提供校验和/签名说明，静态审查无法验证二进制供应链。
SKILL.md 与 references/.md 对 JSON 契约、退出码、dry-run/apply 矩阵（含 `adopt -- --dry-run` 不输出 JSON 这种反直觉行为）、锁冲突、错误消息均有极详细且自洽的描述，失败可诊断性文档层面近乎范例。但静态审查上限 10：无已执行的键路径复现，未见针对 skm 本体命令行为的提交测试证据（workflow 中的测试仅覆盖发布脚本）。
description 明确给出触发条件（管理技能、技能缺失、要求运行 skm）和否定边界（不用于 npx skills、skill-creator、marketplace），Out of scope 表与 Which tool 表进一步收窄；跨平台（含 Windows 权限说明）与 headless 场景适配良好。扣分点：核心依赖需从境外网站/GitHub Releases/ClawHub 获取，未提供国内镜像或校验手段；`--` 语义陷阱多，触发虽准确但正确使用门槛不低。
文档分层良好（SKILL.md → references/.md → references/tools.md），边界声明、安装位置、命名冲突表、许可证（MIT）、版本门控发布（publish-skill.yml 版本变更才发布）都清晰。扣分点：技能自身无 changelog/版本字段，与 app 版本绑定的更新路径依赖 ClawHub 发布流程；发布者身份未经认证，维护责任仅为个人仓库承诺；README 中含广告/赞助内容。
任务（跨 32 个工具同步技能链接）的边际价值明显高于手动建链，CLI 提供机器可读输出适合代理自动化，文档直接可用。但静态审查下无法验证实际输出正确性（如 junction 回退、adopt 移动行为），complete 证据仅来自作者自述，故上限 7，取 6。
有可审计的主材料：源码仓库、MIT 许可、真实 CI 工作流（build.yml 构建 skm 并附到 release，publish-skill.yml 含版本门控与单元测试）。但 CI 测试仅覆盖发布脚本而非技能声明的 skm 行为，JSON 契约无独立复现或第三方佐证，多证据交叉验证不足，静态上限 5，取 4。
- 注意：`skm adopt --` 不带 `--yes` 也会直接应用变更（跳过确认提示），代理调用时务必显式传 `--yes` 并先用 `--dry-run`（人类可读模式）预览。
- `skm doctor --` 恒退出 0，脚本必须按 `issues_count` 判断而非退出码；`fix --yes --` 可能 stdout 有结果同时退出 1。
- CLI 二进制需从境外网站/GitHub Releases 下载，仓库未提供校验和或签名验证指引，下载时注意完整性；该产品未被 Apple 公证。
- 启用工具即在各 AI 工具目录写入符号链接（Windows 下可能退化为受跟踪拷贝），属对本地文件系统的外部副作用，建议用户知情后使用。
- 静态审查未执行任何命令，所有行为描述均来自文档自述，实际结果需用户自行验证。
这个 Skill 能做什么，适合哪些场景？
Skills Manager 是一个免费开源（MIT 协议）的跨平台桌面应用，解决 AI 编码工具技能配置碎片化的问题。它把所有技能集中存放在一个中心仓库（~/.skills-manager/skills），再用符号链接把技能同步到 Claude Code、Codex、Cursor、Gemini CLI 等 32 个工具。应用由 Tauri 2.0（Rust）+ React 19 构建，支持 macOS、Windows 和 Linux。每个版本还附带命令行工具 skm 和一份配套技能 skills-manager-cli，教 Agent 如何在终端中驱动 skm。
skm 初始化中心仓库配置（skm init），把工具目录中已存在的真实技能目录收编进仓库并重新链接（skm adopt），列出技能及每个工具的链接状态（skm list --），为指定工具创建或移除符号链接（skm enable/disable <skill> --for <tool>），检测已安装工具并报告同步问题（skm doctor），修复损坏链接（skm fix --yes）。Windows 上依次尝试目录符号链接、junction（mklink /J）、带来源记录的受控拷贝三种策略。skm 不创建、编辑、搜索或从市场安装技能，这些功能在 GUI 中。
- 在无 GUI 的 SSH/无头服务器上，只想用终端初始化并管理技能目录的工程师（skm init + skm adopt 即可完成纯终端工作流）。
- 同时在 Claude Code、Codex、Cursor、Gemini CLI 等多个工具中使用技能，不想在每个工具目录重复维护副本的开发者。
- 在 Windows 标准账户（无管理员权限）下需要同步技能的用户——junction 策略无需提权。
- 发现某个技能没有出现在 Claude Code 或 Codex 中的用户，可用 skm doctor -- 加 skm list --tool 定位问题并用 skm fix 修复。
- 想把散落在各工具目录里的旧技能统一收进中心仓库的人，用 skm adopt --dry-run 预览后 apply。
- 需要通过 dotfiles 脚本自动化技能配置的终端重度用户。
这个 Skill 有哪些优点和局限？
- MIT 协议，免费开源，本地优先，无云端依赖。
- 一次写入、符号链接同步到 32 个工具，避免多处维护副本。
- GUI 与 CLI 读写同一份配置和链接，可互换使用，支持纯终端无头工作流。
- 为 Agent 调用设计了明确的 -- 契约、dry-run/apply 分离和文档化的退出码行为。
- Windows 无需管理员权限即可同步（junction 回退策略）。
- skm init/adopt 不依赖 GUI，配置幂等且不会覆盖已存在的有效配置。
- 仓库目录固定在 ~/.skills-manager/skills，CLI 不支持自定义路径。
- CLI 无法创建/编辑/搜索/翻译技能，也无法启用或停用工具本身、添加自定义工具——这些都要用 GUI。
- skm 不是独立 npm 包，必须先安装桌面应用或从 Releases 下载二进制，容易被与 npx skills（另一个无关 CLI）混淆。
- init 之后新安装的工具可能一直显示未安装，需要 GUI 重新检测。
- macOS 构建未经 Apple 公证（ad-hoc 签名）；Linux AppImage 在部分虚拟机中需要 WEBKIT_DISABLE_COMPOSITING_MODE=1 才能正常显示。
- 源材料未提供测试套件或独立安全审计的证据。
如何安装这个 Skill？
- 从官网 https://skillsmanager.freeourdays.com/#download 下载对应平台的安装包（macOS .dmg、Windows .msi/.exe、Linux .deb/.AppImage/.rpm），或用 Homebrew：brew tap jiweiyeah/tap && brew install --cask jiweiyeah/tap/skills-manager（注意必须用完整路径，官方仓库有同名 cask）。2. CLI 可单独获取：从 GitHub Releases 下载 skm-<target>.tar.gz（Windows 为 .zip），解压后放入 PATH；或在应用内 Settings → Command Line Tool 安装，或运行 skm init。3. 配套技能位于仓库 skills/skills-manager-cli/SKILL.md，安装 CLI 时会自动复制进仓库并为当前活跃工具启用，也会自动发布到 ClawHub。
如何使用这个 Skill？
对 Agent 来说，这份技能会在需要从终端管理技能、或某个技能在工具中缺失时被触发。典型流程：skm init -- 初始化；skm list -- 查看技能与链接；skm enable <skill> --for <tool> 启用；skm doctor -- 加 skm fix --yes -- 诊断并修复。Agent 约定：init/list/doctor/fix/adopt 优先用 --；apply 类命令加 --yes 避免阻塞在确认提示；doctor -- 即使有问题也退出码为 0，应检查 .issues_count；fix --yes 失败时读取 stdout 中的 failed[].message，不要循环重试。skm 无法更换仓库目录（固定 ~/.skills-manager/skills），市场搜索/安装、技能编写、翻译、自定义工具等均在 GUI 完成。