agent-skills 是 Addy Osmani 给 AI 编码 agent 做的一套生产级工程 skill。它的定位很具体:不是让 agent “更好”的 prompt,而是把资深工程师用的工作流和质量门编码下来,按软件生命周期从定义工作到发布组织。作者在这里很关键。Osmani 是 Google 的工程总监,也是长期的 web 性能权威,这些 skill 内嵌了 Google 自家工程文化的理念。这个出身既是它迅速吸引数万 star 的原因,也是评判它的视角。
里面有什么
共 23 个 skill(22 个生命周期 skill 加 1 个处理路由的元 skill),按阶段分组:
- **Define:**interview-me、idea-refine、spec-driven-development。
- **Plan:**planning-and-task-breakdown。
- **Build:**incremental-implementation、test-driven-development、context-engineering、source-driven-development、frontend-ui-engineering、api-and-interface-design 等。
- **Verify:**browser-testing-with-devtools、debugging-and-error-recovery。
- **Review:**code-review-and-quality、code-simplification、security-and-hardening、performance-optimization。
- **Ship:**git-workflow-and-versioning、ci-cd-and-automation、documentation-and-adrs、shipping-and-launch。
每个 skill 是一份结构化的 SKILL.md,含流程、验证门、反合理化表(常见借口配上反驳)和红旗指标。另有专家人格(code-reviewer、test-engineer、security-auditor)和参考清单。
区分性的思路
README 明确指出这些 skill 编码了 Google 工程文化的实践,引用了 Hyrum 定律、测试的 Beyonce 规则、简化的 Chesterton 栅栏、主干开发等理念。这是值得停留的差异点:很多 skill 合集是个人偏好,而这一个声称以一套有据可查的工程传统为来源。它是否打动你,取决于你想把 agent 推向大公司式的严谨(规格、测试、评审、安全门)还是推向速度。
安装
# Claude Code
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills除 Claude Code 外,它支持 Cursor(把 SKILL.md 复制到 .cursor/rules/)、Gemini CLI、Windsurf、OpenCode、Copilot、Kiro,加上一个通用 markdown 系统 prompt 路径。七个顶级命令映射生命周期:/spec、/plan、/build、/test、/review、/code-simplify、/ship。/build auto 模式会生成计划并逐个切片实现,遇风险暂停。
适合与不适合
适合:想让 agent 表现得像一位有纪律的资深工程师的团队:先写规格、用测试证明、发布前做质量与安全评审。不太适合:用完即弃的脚本或快速原型,那里这些门只会添你不想要的摩擦。它有主见地偏向可靠性而非速度:对生产代码是对的取舍,对周末玩票是错的。
横向对比
| 项目 | 角度 | Stars(2026-06) |
|---|---|---|
| addyosmani/agent-skills | Google 实践的质量门 | ~52k |
| obra/superpowers | 技能框架 + 方法论 | ~220k+ |
| anthropics/skills | 第一方 agent skill | 第一方基线 |
| mattpocock/skills | 一位工程师的 .claude 目录 | 个人、策展 |
superpowers 是更广的方法论框架;anthropics/skills 是官方基线;mattpocock/skills 是分享出来的个人目录。agent-skills 的小生态是那个明确的”这是 Google 工程师怎么干”的框架,加上验证门和反合理化表：当 agent 想偷工减料时,它会顶回去。
issue 里的坑
项目年轻(2026 年初创建),开放 issue 多是集成和路由,而非核心缺陷:
- 含空格的插件路径可能破坏 SessionStart hook(#214)。
- code-reviewer 人格与 code-review-and-quality skill 之间有被记录的路由歧义(#173),所以元 skill 的路由还在收紧。
- 几个 issue 请求对更多宿主的一等支持(例如 Antigravity,#226、#177)。
结论:skill 本身扎实,摩擦在安装路径和 23 个相互重叠的 skill 之间的路由上。元 skill 正是为管这件事而存在,且仍在成熟中。
FAQ
addyosmani/agent-skills 免费吗? 是。agent-skills 是 MIT 许可的开源项目,无付费档。
agent-skills 有多少个 skill? 23 个:22 个覆盖 define、plan、build、verify、review、ship 的生命周期 skill,加 1 个在它们之间路由的元 skill。
agent-skills 支持 Cursor 和 Gemini 吗? 支持。除 Claude Code 外,它支持 Cursor、Gemini CLI、Windsurf、OpenCode、Copilot、Kiro,加一个通用 markdown 系统 prompt 路径。
怎么在 Claude Code 装 agent-skills? 跑 /plugin marketplace add addyosmani/agent-skills 再 /plugin install agent-skills@addy-agent-skills。
addyosmani/agent-skills 和别的 skill 合集有什么不同? 它明确编码了 Google 工程文化的实践(Hyrum 定律、Beyonce 规则、主干开发),并带验证门和反合理化表——当 agent 想跳过测试或偷工减料时会顶回去。它偏向可靠性而非速度,更适合生产代码而非快速原型。作者作为 Google 工程总监和 web 性能权威的背景,也是这个仓库迅速积累数万 star 的很大原因,所以按内容本身、而非仅凭名气来掂量。
相关阅读
对比 obra/superpowers 的更广框架、anthropics/skills 的第一方基线,以及 mattpocock/skills 的个人合集。要远更宽的角色库,见 msitarzewski/agency-agents。