[小工具] 做了个基于 vercel-labs/skills 把 skills 同步到 github 的 cli 工具

[tc9011]

最近在用 Vercel 的 ai-skills (vercel-labs/skills) 管理各种 AI Agent 的技能包，确实挺好用。但发现它有两个痛点：

不支持跨机器同步：公司电脑配置好的 Prompt 和 Skills ，回家换台电脑就得重新弄。
Agent 太多不好管：手动去各个 Agent 的配置目录（比如 ~/.cursor/skills 或 ~/.claude/skills ）建软链太麻烦。
为了解决这个问题，我写了这个 CLI 工具：skills-manager 。

它不仅是一个 vercel-labs/skills 的伴侣工具，还自带了一个专门的 Skill ，让你的 AI Agent 学会自己使用这个工具来管理技能。

✨ 核心功能
🧠 自带 Skill (Teach AI to manage AI)：包含一个 skills-manager skill 。安装后，你的 Agent (比如 Claude Code 或 OpenClaw) 就能听懂自然语言指令，比如 "帮我把现在的 Skills 备份到 GitHub" 或者 "拉取最新的 Skills 并同步到 Cursor"。
🔄 跨机器同步 (Git-based)：把你的 ~/.agents/ 目录当作 Git 仓库，一键 push/pull ，换台机器直接还原所有配置。
🔗 自动链接 (Auto Link)：自动识别本机安装的 Agent （支持 41 种，包括 Cursor, Claude Code, OpenClaw, Copilot 等），并建立软链。
📂 项目级集成：支持把 Skills 集成到当前项目目录（如 .cursor/skills/），方便随项目代码提交，适合团队共享 Prompt 。


🚀 快速使用 (CLI 方式)
你可以直接用 npx 运行，或者全局安装以便随时调用：

方式 A：全局安装
npm install -g @tc9011/skills-manager

# 以后直接敲简短命令：
skills-manager push
skills-manager pull
skills-manager link

方式 B：直接运行 (免安装)
npx @tc9011/skills-manager push



常用操作流程：

1. 备份你的 Skills
skills-manager push
# 自动 commit 并 push 到你的远程仓库

2. 在新机器恢复
skills-manager pull --repo your-github-name/my-skills
# 拉取后会自动触发 link ，把技能配置到本地所有 Agent

3. 自动软链 / 项目级集成 (Link)
当你安装了新 Agent 或进入新项目时，随时刷新配置：

# 全局模式：自动扫描本机所有 Agent 并建立软链
skills-manager link

# 项目模式：把选定的 Skills 直接集成到当前项目目录 (适合团队协作)
skills-manager link --project



🤖 让 Agent 自己管理 (Skill 方式)
如果你已经在使用 vercel-labs/skills ，可以通过它直接安装这个 Skill：

# 给 Claude Code 或 OpenCode 安装管理技能
npx skills add tc9011/skills-manager --skill skills-manager
安装后，你就可以直接对 Agent 说话了：

"User: 帮我把刚才写的那个新 skill 备份一下。"
"Agent: 好的，正在运行 skills-manager push..."

🔗 地址
GitHub: https://github.com/tc9011/skills-manager
NPM: https://www.npmjs.com/package/@tc9011/skills-manager
欢迎大家试用，觉得好用的话求个 Star ⭐️！如果有 bug 或者新的 Agent 路径支持需求，可以在 Issue 里提~

[korvin]

刚好有这需求，试试
另外，skills-manager 命令太长了，建议缩写：sm

[korvin]

我执行了 skills-manager push 提示成功了，远端仓库也没有。
一开始没有建远端仓库，push 也没报错，我没找到，所以又去 github 手动建了远端仓库，再执行 push 还是没有。

[tc9011]

@korvin 你是全局安装还是用 npx ，npx 要加上 scope ，因为有一个同名的包

[tc9011]

@korvin 这个加上了

[korvin]

@tc9011 #3 执行的是 npx @tc9011/skills-manager push 这个命令，第一次有让我填写 username/repo 但那时我还没有 gh cli 和相应的 token ，远程也没对应的仓库。后面我老板盏了 gh cli 和远程仓库，再 push 还是没啥效果。