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

3 月 4 日
 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 里提~
1498 次点击
所在节点    分享创造
10 条回复
korvin
3 月 5 日
刚好有这需求,试试
另外,skills-manager 命令太长了,建议缩写:sm
korvin
3 月 5 日
我执行了 skills-manager push 提示成功了,远端仓库也没有。
一开始没有建远端仓库,push 也没报错,我没找到,所以又去 github 手动建了远端仓库,再执行 push 还是没有。
tc9011
3 月 5 日
@korvin 你是全局安装还是用 npx ,npx 要加上 scope ,因为有一个同名的包
tc9011
3 月 5 日
@korvin 这个加上了
korvin
3 月 5 日
@tc9011 #3 执行的是 npx @tc9011/skills-manager push 这个命令,第一次有让我填写 username/repo 但那时我还没有 gh cli 和相应的 token ,远程也没对应的仓库。后面我老板盏了 gh cli 和远程仓库,再 push 还是没啥效果。
tc9011
3 月 5 日
@korvin 你再试试
korvin
3 月 6 日
还是没有用 @tc9011
tc9011
3 月 6 日
@korvin 感谢反馈,好像是没有检查历史 commit ,你再试试
korvin
3 月 6 日
@tc9011 #8 可以了,感觉。对了这个是从哪个目录提交上去的,是只能支持 vercel-labs/skills 安装方式的 skills ,还是其它方式安装的也支持?
tc9011
3 月 8 日
@korvin 暂时不支持其他目录,现在是把 vercel/skills 命令的 global 安装方式的 ~/.agents 目录提交

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/1195876

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX