开发与工程

Skills Manager CLI(skm)技能

一份技能同步到 32 个 AI 编程工具:用 skm 命令行管理技能枢纽、符号链接与同步修复。

59/ 100
推荐

整体可靠,存在已披露的局限;按说明试用并保留回滚路径。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 1.1k
最近更新
1 个月前
License
MIT
skills-managementsymlink-syncclitauri
+3codexcross-platformmit-license

这个 Skill 能做什么,适合哪些场景?

Skills Manager 是一款开源(MIT)桌面应用,把每份技能只写一份存入中央枢纽(~/.skills-manager/skills),再用符号链接同步到 Claude Code、Codex、Cursor、Gemini CLI 等 32 个 AI 编程工具。skm 是随附的命令行前端,与桌面应用读写同一份配置和链接,适合 SSH、无头服务器或纯终端工作流。本技能教代理如何正确调用 skm:初始化、启用/禁用、体检与修复。注意 skm 不负责编写或搜索技能内容,那些功能在 GUI 或其他工具中。

运行 skm init 初始化 ~/.skills-manager/config. 并检测本机已安装的 AI 工具;运行 skm list -- 查看枢纽中的技能及各工具的链接状态;运行 skm enable/disable <skill> --for <tool> 创建或移除符号链接(Windows 上依次尝试符号链接→junction→受控复制);运行 skm adopt 把工具目录里已存在的真实技能目录迁入枢纽并重新链接(支持 --dry-run 预览);运行 skm doctor 诊断工具检测与链接问题,skm fix --yes 自动修复。

适合
  • 在无 GUI 的 SSH/无头服务器上,用 skm init + adopt 完成全套终端化技能管理
  • 排查『某技能在 Claude Code/Codex 里没显示』:doctor 定位问题,fix 修复断链
  • 把某工具目录下手工放置的技能目录收编(adopt)进枢纽,避免绕过枢纽管理
  • 只给用户点名的那个工具开启某技能,而不是盲目对所有工具全开
不适合
  • 想搜索/安装 skills.sh 市场技能的用户——skm 不含 marketplace 功能,应改用 npx skills 或 GUI
  • 想用 skm 编写 SKILL.md、打标签、翻译内容或增删自定义工具的用户——这些只能在 GUI 完成
  • 想更换枢纽目录位置的用户——CLI 不支持,固定为 ~/.skills-manager/skills

如何安装这个 Skill?

使用前请注意
  • 注意:`skm adopt --` 不带 `--yes` 也会直接应用变更(跳过确认提示),代理调用时务必显式传 `--yes` 并先用 `--dry-run`(人类可读模式)预览。
  • `skm doctor --` 恒退出 0,脚本必须按 `issues_count` 判断而非退出码;`fix --yes --` 可能 stdout 有结果同时退出 1。
  • CLI 二进制需从境外网站/GitHub Releases 下载,仓库未提供校验和或签名验证指引,下载时注意完整性;该产品未被 Apple 公证。
  • 启用工具即在各 AI 工具目录写入符号链接(Windows 下可能退化为受跟踪拷贝),属对本地文件系统的外部副作用,建议用户知情后使用。
  • 静态审查未执行任何命令,所有行为描述均来自文档自述,实际结果需用户自行验证。
开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 本地文件系统
需要预先安装
  • Skills Manager desktop app or skm binary (GitHub Releases)
  • terminal / shell access

先安装 Skills Manager 桌面应用或独立的 skm 二进制,本技能会随 skm init 自动装入枢纽。各安装途径:

桌面应用(macOS Homebrew)

brew tap jiweiyeah/tap
brew install --cask jiweiyeah/tap/skills-manager

独立 CLI(GitHub Releases)

# 从 https://github.com/jiweiyeah/skills-manager/releases 下载 skm-<target>.tar.gz(Windows 为 .zip),解压后放入 PATH
skm --version

本技能随 CLI 初始化自动安装

skm init --

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • 帮我在这台 SSH 服务器上初始化 skm,并把工具目录里已有的技能收编进枢纽
  • 我的 ab-testing 技能在 Claude Code 里没显示,用 skm 诊断并修复
  • 只给 Codex 启用枢纽里的 skills-manager-cli 技能,其他工具不要动
  • 列出当前所有技能及各工具的链接状态,用 JSON 输出

当用户或代理需要从终端、SSH、CI 或无头机器管理技能时触发。典型流程:

skm init --          # 首次运行,幂等
skm adopt --dry-run      # 预览可收编的目录
skm adopt --yes --   # 收编并重新链接
skm list --          # 确认状态
skm doctor --        # 体检(注意:以 issues_count 而非退出码判断)
skm fix --yes --     # 修复发现的问题

要点:enable/disable 无 --;写命令有建议锁,冲突时重试一次;-- 模式下错误以 {"error":"..."} 输出到 stderr;fix/adopt 须加 --yes 才真正生效。

这个 Skill 有哪些优点和局限?

优点
  • GUI 与 CLI 读写同一配置,可互换使用,适合 dotfiles 脚本与无头环境
  • 设计面向代理调用:-- 输出、幂等 init、dry-run 预览、建议锁防并发写
  • 开源 MIT,跨 macOS/Windows/Linux,支持 32 个 AI 工具并可扩展自定义工具
  • 符号链接同步无文件复制,Windows 普通账户三种降级策略即可工作
局限
  • CLI 不能编写、编辑、搜索、翻译技能,也不能访问市场——需要 GUI 配合
  • 工具的 enabled/detected 标志 CLI 无法修改,需回 GUI Tools 页面处理
  • skm 不是独立 npm 包,必须先装桌面应用或从 Releases 下载二进制
  • init 后新装的工具可能一直显示 not installed,直到 GUI 重新检测;macOS 构建未经 Apple 公证

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
Skills Manager CLI(skm)技能 本页 59 · 推荐 ★ 1.1k 1 个月前 MIT
Engram 持久记忆协议 68 · 推荐 ★ 7.7k 8 天前 MIT
Vibe Replay 会话回放 56 · 谨慎使用 ★ 38 7 天前 MIT
Multica 技能导入器 56 · 谨慎使用 ★ 54k 6 天前 NOASSERTION
OpenSkills 通用技能加载器 54 · 谨慎使用 ★ 11k 9 个月前 NOASSERTION

与 skills.sh 的 npx skills CLI 是不同且无关的工具:skm 只做本地枢纽与符号链接管理,不做市场搜索/安装;GUI 版提供市场、翻译、标签等 CLI 未覆盖的功能。

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
推荐
59/ 100 五分制 3.0 / 5
1信任安全16 / 25 · 3.2/5

技能本身仅驱动本地 CLI:无网络调用、无凭据读取,操作范围限于 ~/.skills-manager 与各工具技能目录的符号链接;写入命令有 advisory lock,Windows 回退链(symlink→junction→tracked copy)透明记录来源。扣分点:`adopt` 会移动用户真实目录,且 `--` 不带 `--yes` 也会跳过确认直接应用(文档自己承认),对代理调用者存在误触发即产生变更的风险;二进制需从网站或 Releases 下载,未提供校验和/签名说明,静态审查无法验证二进制供应链。

2可靠稳定10 / 20 · 2.5/5

SKILL.md 与 references/.md 对 JSON 契约、退出码、dry-run/apply 矩阵(含 `adopt -- --dry-run` 不输出 JSON 这种反直觉行为)、锁冲突、错误消息均有极详细且自洽的描述,失败可诊断性文档层面近乎范例。但静态审查上限 10:无已执行的键路径复现,未见针对 skm 本体命令行为的提交测试证据(workflow 中的测试仅覆盖发布脚本)。

3适用触发12 / 15 · 4.0/5

description 明确给出触发条件(管理技能、技能缺失、要求运行 skm)和否定边界(不用于 npx skills、skill-creator、marketplace),Out of scope 表与 Which tool 表进一步收窄;跨平台(含 Windows 权限说明)与 headless 场景适配良好。扣分点:核心依赖需从境外网站/GitHub Releases/ClawHub 获取,未提供国内镜像或校验手段;`--` 语义陷阱多,触发虽准确但正确使用门槛不低。

4规范维护11 / 15 · 3.7/5

文档分层良好(SKILL.md → references/.md → references/tools.md),边界声明、安装位置、命名冲突表、许可证(MIT)、版本门控发布(publish-skill.yml 版本变更才发布)都清晰。扣分点:技能自身无 changelog/版本字段,与 app 版本绑定的更新路径依赖 ClawHub 发布流程;发布者身份未经认证,维护责任仅为个人仓库承诺;README 中含广告/赞助内容。

5有效结果6 / 15 · 2.0/5

任务(跨 32 个工具同步技能链接)的边际价值明显高于手动建链,CLI 提供机器可读输出适合代理自动化,文档直接可用。但静态审查下无法验证实际输出正确性(如 junction 回退、adopt 移动行为),complete 证据仅来自作者自述,故上限 7,取 6。

6证据核验4 / 10 · 2.0/5

有可审计的主材料:源码仓库、MIT 许可、真实 CI 工作流(build.yml 构建 skm 并附到 release,publish-skill.yml 含版本门控与单元测试)。但 CI 测试仅覆盖发布脚本而非技能声明的 skm 行为,JSON 契约无独立复现或第三方佐证,多证据交叉验证不足,静态上限 5,取 4。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年9月18日 审查版本 bc3c8bd68cfe 评估证据[1][2][3][4][5][6][7][8][9][10]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

需要管理员权限吗?
Windows 上不需要:依次尝试符号链接(需开发者模式)、junction(普通账户即可)、受控复制三种策略。
skm 能单独 npm 安装吗?
不能。它随桌面应用分发(设置→命令行工具),或从 GitHub Releases 下载独立二进制。
doctor 退出码为 0 就说明没问题吗?
不是。doctor -- 即使有问题也退出 0,应以输出中的 issues_count 为准。
枢纽目录能改位置吗?
不能,CLI 固定使用 ~/.skills-manager/skills(Windows 为 %USERPROFILE%\.skills-manager\skills)。

相关 Skills