skillmod：像 go mod 一样管理 Agent Skills

[huija]

V 友也有很多开源的 skill 管理客户端，但是感觉用起来还是比较麻烦，很多工具也都是做拷贝，强迫症很难受。

所以做了 skillmod ，把 go mod 的同构方案搬到 skill 上：

skillmod init 初始化 skill 依赖(下面 mod 和 lock 不需要人维护，是声明式的记录)
SKILL.mod 声明项目需要哪些 skill ，人维护、进版本库
SKILL.lock 用内容 dirhash 锁定版本，tag 或 commit 号都行，任何篡改在 verify 时无所遁形
skillmod sync 幂等对齐，多台机器直接拉齐
skillmod share 把同一套安装链接给 .claude 、.codex 等任意 agent

效果：

• 换电脑：sync 一条命令拉齐；本地跑 verify ，确认内容和 lock 完全一致
• 多项目复用：本机有共享持久存储，skill 只取一次，项目内安装很快——各项目只装自己需要的
• 团队协作：SKILL.mod 进仓库，新人 clone 后 sync 拿到统一环境，谁在用哪个版本的 skill 一目了然
• 全局 skill 统一接管：init --global 直接把你现有的全局 skill （如 ~/.claude/skills ）纳入 skillmod 管理，版本、来源、更新全都在掌控中

设计细节：

• 安装范围：默认项目级，仅当前项目可用；加 --global 装到用户主目录，所有项目通用，目前都支持--global,支持 dry run ，支持 tui 交互。
• 安装方式：主推通过 Agent-native CLI 安装（如 npx skills add ），让 agent 自己管理技能挂载；也可用 skillmod get 手动安装，默认软链接，单一数据源、更新方便；需要完整副本时手动指定 --install-mode=copy
• 无 registry：skill 就是 Git 仓库，tag 或 commit 号即版本。内外网仓库都支持，只要 Git 能 clone 到
• 扁平 1:1：一个仓库对应一个 skill ，结构简单，零遥测，外部依赖只有 Git

上手：

# 0. 安装（推荐：让 agent 自己安装，然后让 AI 安装 skillmod 并放到 PATH 内,也可以用 go install 安装代替 AI 下载 bin ）
npx skills add github.com/openai/skills//gh-fix-ci --yes

# 1. 项目初始化：生成 SKILL.mod （项目根目录）
skillmod init

# 2. 全局接管：把现有全局 skill 纳入 skillmod 管理
skillmod init --global

# 3. 添加 skill
#    手动安装（默认软链接，项目级）
# skillmod get github.com/openai/skills//gh-fix-ci --yes
#    全局安装（装到用户主目录）
# skillmod get github.com/openai/skills//gh-fix-ci --global --yes

# 4. 本地验证内容一致性
skillmod verify

局限说一句：verify 锁的是内容 hash ，不做内容安全审查，装第三方 skill 前自己看一眼。

• GitHub: https://github.com/huija/skillmod
• 文档： https://huija.github.io/skillmod

觉得有用点个 Star ⭐，欢迎 issue ， 自己主要用 Linux, mac 理论上一样，所有的 skill 都会软链到全局 mod 内，windows 没测。。

纯 vibe coding ，v0.0.1 后就自举让 AI 开发了