aweskill:让AI Agents 可以搞定skills 管理-夜雨聆风

aweskill:让AI Agents 可以搞定skills 管理

你同时用好几个 AI 编码工具。Claude Code 做深度重构，Cursor 做快速编辑，Codex 跑自主任务，Gemini CLI 做多模态工作，可能还有 Windsurf 或 Qwen Code。

每个工具有自己的 skill 目录，SKILL.md 放的位置各不相同。每发现一个好用的 skill，你就复制一次。然后再复制一次。再复制一次。

一个月后：一份过期了，一份坏了，一份有谁也记不清的本地改动，没人知道到底哪份才是最新的。

这就是 aweskill 要解决的问题。

官网：aweskill.webioinfo.top^[1]

真正的问题不是第一天——是第三十天

给一个 agent 装个 skill 很简单，大多数工具都能做到。

难的是之后：

• 哪份是真的？ 同一个 pr-review skill 存在于 ~/.claude/skills/、~/.cursor/skills/、~/.codex/skills/。你改哪个？
• 怎么更新？ 上游作者修了个 bug，你得找到每一份副本，逐个替换。
• 怎么组织？ 你有 15 个 skill，有些是后端的，有些是前端的，有些只想在 Codex 里用，有些要全局启用。
• 怎么恢复？ 一个 symlink 断了，一个 agent 更新把你的 skill 目录清空了。怎么办？
• 怎么避免复制怪圈？ 每加一个新 agent，就再来一轮手工复制。

aweskill 把 skill 当成长期本地资产来管理——不是装一次就不管了的东西。

aweskill 是什么？

aweskill 是面向 AI Agent 的本地 Skill 包管理器。可以把它想象成 SKILL.md 文件的 npm。

它在 ~/.aweskill/skills/ 维护一份中央 skill 仓库，然后通过 symlink（Windows 上用 junction 或托管副本）把选中的 skill 投影到各个 agent 需要的目录。

核心亮点

#	特性	为什么重要
1	中央仓库	每个 skill 只有一份，放在 `~/.aweskill/skills/`。不再有散落各处的重复副本。
2	多 Agent 投影	同一个 skill，四个 agent，一条命令。支持 47 个 agent，包括 Claude Code、Cursor、Codex、Gemini CLI、Windsurf 等。
3	Bundle 打包	按工作流（”backend”、”frontend”、”daily-coding”）分组 skill，一次性投影整组。
4	来源追踪更新	`aweskill` 记录每个 skill 来自哪里。`aweskill update` 拉取上游更新，同时保护你的本地修改。
5	内置 Agent 管理技能	自带 `aweskill` 和 `aweskill-doctor` 元技能——AI agent 能通过自然语言管理 skill。
6	本地维护能力	备份、恢复、查重、清理、同步、修复——全部集成在一个 CLI 里。
7	官网与文档入口	aweskill.webioinfo.top^[1] 提供安装说明、定位说明和 agent 兼容性总览。

对比：aweskill vs 其他工具

能力	cc-switch^[2]	sciskill^[3]	Skills Manager^[4]	skillfish^[5]	vercel-labs/skills^[6]	skills-manage^[7]	aweskill
中央本地 skill 仓库	否	否	是	否	否	是	是 — `~/.aweskill/skills/`
registry / catalog 发现能力	否	是	否	是	是	是	是 — skills.sh + sciskillhub + 本地仓库
GitHub 风格仓库导入/安装	是	否	否	是	是	是	是
本地路径导入/安装	否	否	否	否	是	否	是
按来源追踪更新	否	否	否	是	是	否	是 — 保护本地修改
多 agent 即插即用投影	是	否	是	是	是	是	是 — symlink/junction/copy
bundle / manifest / collection 分组	否	否	否	是	否	是	是
可被 agent 调用的管理技能	否	否	否	否	否	否	是 — 内置元技能
本地维护与恢复	否	否	否	否	否	否	是 — backup、dedup、clean、recover

结论：其他工具能安装 skill。aweskill 管理整个生命周期——发现、安装、组织、更新、维护、恢复——覆盖你使用的每一个 agent。

使用场景

场景 1：独立开发者中途切换 Agent

你在 Claude Code 里开始写一个功能，做了一半切到 Cursor 写 UI，然后用 Codex 生成测试用例。三个 agent 都需要同样的 pr-review 和 bug-triage skill。

没有 aweskill：

• 复制 pr-review/SKILL.md 到 ~/.claude/skills/pr-review/
• 再复制到 ~/.cursor/skills/pr-review/
• 再复制到 ~/.codex/skills/pr-review/
• 对 bug-triage 再来一遍
• 祈祷它们保持同步

用 aweskill：

aweskill agent add skill pr-review,bug-triage --global --agent claude-codeaweskill agent add skill pr-review,bug-triage --global --agent cursoraweskill agent add skill pr-review,bug-triage --global --agent codex

一个源头，三个投影，零冗余。

场景 2：团队负责人构建标准 Skill 集

团队同时使用 Claude Code 和 Cursor。你希望每个成员都有相同的核心 skill：代码审查、测试指南、API 设计规范、发布清单。

没有 aweskill： 分享一个 Google Doc，列出需要手动安装哪些 skill。但每个人装出来的结果都不一样。

用 aweskill：

aweskill bundle create team-standardaweskill bundle add team-standard pr-review,test-guidelines,api-design,release-checklistaweskill agent add bundle team-standard --global --agent claude-codeaweskill agent add bundle team-standard --global --agent cursor

每个团队成员跑同样的两条 agent add 命令，就能获得完全一致的 skill 配置。Bundle 定义是一个简单的 YAML 文件，可以直接提交到共享仓库。

场景 3：Skill 作者发布了更新

你从 skills.sh 下载了一个 security-review skill。作者刚发布了改进版，覆盖了 OWASP 2025。

没有 aweskill： 翻遍四个 agent 目录，下载新版本，手动替换每一份副本，祈祷没遗漏。

用 aweskill：

aweskill update --check           # 查看哪些有更新aweskill update security-review   # 拉取更新到中央仓库

所有已投影的 agent 自动获取更新——它们指向同一个中央副本。

场景 4：科研人员使用科研类 Skill

你在 sciskillhub.org 发现了一个蛋白质组学分析 skill，想同时在 Gemini CLI 和 Claude Code 里使用。

aweskill find proteomicsaweskill install sciskill:open-source/research/lifesciences-proteomicsaweskill agent add skill lifesciences-proteomics --global --agent gemini-cliaweskill agent add skill lifesciences-proteomics --global --agent claude-code

一次安装，多个 agent，来源已追踪。

场景 5：灾难恢复

一次 agent 更新清空了你的 ~/.cursor/skills/ 目录。你精心整理的所有 skill 全没了。

没有 aweskill： 从头开始，重新下载所有内容，凭记忆重建整个配置。

用 aweskill：

aweskill store backup                          # 你上周跑过这个aweskill store restore ~/Downloads/aweskill-backup.tar.gzaweskill agent add bundle daily-coding --global --agent cursor

中央仓库恢复，Bundle 重新投影，继续工作。

直接让 Agent 帮你安装 aweskill

这个工作流里最顺手的一点，是你不一定要自己手工完成引导。可以直接把安装协议交给当前 coding agent：

Read https://github.com/mugpeng/aweskill/blob/main/README.ai.md and follow it to install aweskill.

一次流程里，agent 就能完成 CLI 安装、central store 初始化、当前运行环境识别、aweskill 和 aweskill-doctor 投影，并在最后提醒你重启，让新 skills 正式生效。

快速开始

安装：

npm install -g aweskillaweskill store init

查找并安装 skill：

aweskill find pr-reviewaweskill install owner/repo

投影到所有 agent：

aweskill agent add skill pr-review --global --agent claude-codeaweskill agent add skill pr-review --global --agent codexaweskill agent add skill pr-review --global --agent cursoraweskill agent add skill pr-review --global --agent gemini-cli

或用 bundle 一次投影整组：

aweskill bundle create daily-codingaweskill bundle add daily-coding pr-review,bug-triage,release-checklistaweskill agent add bundle daily-coding --global --agent claude-codeaweskill agent add bundle daily-coding --global --agent cursor

让 AI Agent 自主管理 Skill

aweskill 自带两个内置元技能。先把它们投影到当前 agent：

aweskill agent supportedaweskill agent add skill aweskill,aweskill-doctor --global --agent codexaweskill agent list --global --agent codex

把 codex 替换成你的 agent id。

你的 AI agent 可以响应这样的请求：

• “帮我给所有 agent 安装最新的 pr-review skill”
• “检查一下有没有 skill 需要更新”
• “清理仓库里的重复 skill”
• “备份我的 skill 仓库”

Agent 会代替你运行 aweskill 命令。这让 aweskill 从”你管理的工具”变成了”agent 可以自管理的工具”。

47 个 Agent，还在增加

aweskill 目前支持 47 个 AI 编码 agent：

Claude Code、Cursor、Windsurf、Codex、GitHub Copilot、Gemini CLI、OpenCode、Goose、Amp、Roo Code、Kiro CLI、Kilo Code、Trae、Cline、Antigravity、Droid、Augment、OpenClaw、CodeBuddy、Crush、Kode、Mistral Vibe、Mux、OpenClaude IDE、OpenHands、Qoder、Qwen Code、Replit、Neovate、AdaL 等等。

完整列表见 README^[8]。

什么时候该用 aweskill

如果你符合以下情况：

• 同时使用多个 AI 编码 agent
• 希望有一个本地唯一的 skill 来源
• 需要在 Claude Code、Cursor、Codex、Gemini CLI 等之间共享 skill
• 想用 bundle 代替手工复制
• 在乎来源追踪更新和可恢复的本地状态
• 希望 AI agent 能通过自然语言管理 skill

你可能不需要，如果：

• 只用一个 agent，且不打算切换
• 安装一次 skill 后再也不动

总结

安装一个 skill 不是难题。让它始终保持更新、有条理、跨 agent 一致、出了问题还能恢复——这才是难题。

aweskill 解决的是第三十天的问题。中央仓库、多 agent 投影、来源追踪更新、Bundle 组织、内置维护、Agent 可调用管理。

如果你同时在多个 AI agent 之间工作，aweskill 能把散落的 skill 文件夹变成真正可管理的东西。

官网：aweskill.webioinfo.top^[1]

立即安装：npm install -g aweskill

GitHub：github.com/mugpeng/aweskill^[9]

npm：npmjs.com/package/aweskill^[10]

引用链接

[1] aweskill.webioinfo.top: https://aweskill.webioinfo.top/[2] cc-switch: https://github.com/farion1231/cc-switch[3] sciskill: https://github.com/sciskillhub/sciskill[4] Skills Manager: https://github.com/jiweiyeah/Skills-Manager[5] skillfish: https://github.com/knoxgraeme/skillfish[6] vercel-labs/skills: https://github.com/vercel-labs/skills[7] skills-manage: https://github.com/iamzhihuix/skills-manage[8] README: https://github.com/mugpeng/aweskill#supported-agents[9] github.com/mugpeng/aweskill: https://github.com/mugpeng/aweskill[10] npmjs.com/package/aweskill: https://www.npmjs.com/package/aweskill

真正的问题不是第一天——是第三十天

aweskill 是什么？

核心亮点

对比：aweskill vs 其他工具

使用场景

场景 1：独立开发者中途切换 Agent

场景 2：团队负责人构建标准 Skill 集

场景 3：Skill 作者发布了更新

场景 4：科研人员使用科研类 Skill

场景 5：灾难恢复

直接让 Agent 帮你安装 aweskill

快速开始

同类工具推荐

让 AI Agent 自主管理 Skill

47 个 Agent，还在增加

什么时候该用 aweskill

总结

引用链接