Agent Skills（addyosmani 出品，MIT，约 9 万星）是把资深工程师的工作方式打包成技能集：24 个技能（测试驱动开发、规格驱动开发、代码审查、安全加固、性能优化……）+ 8 个生命周期斜杠命令（/spec /plan /build /test /review /ship 等）。技能会按你正在做的事自动激活——设计 API 时装载 api-and-interface-design，改 UI 时装载 frontend-ui-engineering。

一句话：给 Agent 一套"资深工程师的肌肉记忆"。

你的 AI 写代码很快，但经常「上来就写」：没有规格、没有计划、改完不测试。你想让它像资深工程师一样按流程走——先想清楚需求、拆成小任务、一步步实现、测试通过再合并。Agent Skills 就是装进 AI 的工程流程技能包：24 个技能 + 8 个斜杠命令，覆盖定义→规划→构建→测试→审查→上线全流程。

下面这条命令先试官方 skills CLI，GitHub 慢装不上时自动退回 codeload 镜像手工复制：

# 来源: Trove 详细指南 · 验证于 2026-08-28
npx -y skills add addyosmani/agent-skills --yes --global 2>/dev/null || (curl -sL https://codeload.github.com/addyosmani/agent-skills/tar.gz/refs/tags/0.6.7 | tar xz && cp -r agent-skills-0.6.7/skills ~/.claude/skills/agent-skills)

预期输出: 技能目录就位（~/.claude/skills/agent-skills/ 下按技能名分目录，共 24 个）

1. ls ~/.claude/skills/agent-skills | wc -l 输出 24；
2. 新开一个 Claude Code 会话输入 /spec，AI 按规格流程响应，而不是直接开写；
3. 相关任务提示里出现技能引用（自动激活生效）。

AI 默认只执行「你给的一句话」，不会自己走工程流程。Agent Skills 的做法是给 AI 一份「干活手册」：每个技能是一个 SKILL.md 目录（共 24 个），Claude Code 这类 Agent 会按任务主题自动装载对应技能，也可以用斜杠命令手动触发整条流程。它不改 AI 本身，只是往技能目录里放东西（~/.claude/skills/agent-skills/ 或项目 .claude/skills/），无 CLI 二进制、无后台进程。

实测命令 = skills CLI（vercel-labs/skills，npx skills add addyosmani/agent-skills；本环境 GitHub clone 慢超时，改用 codeload tarball 1.9s 取到 24 个 SKILL.md + 8 个斜杠命令，结构确认）；官方快速路径 = npx skills add addyosmani/agent-skills（装到 70+ agent，含 Claude Code/Cursor/Codex/Copilot）；手工路径 = 复制 skills/ 目录；写面 = 技能目录（~/.claude/skills 或项目 .claude/skills，与 superpowers 同面）

第 1 步：装技能包（国内优先手工复制）

为什么有两种方式：方式 A 是官方推荐的 skills CLI（npx -y skills add ...），支持 70+ agent 自动放对位置；但它在 GitHub 拉仓库，国内经常卡住。方式 B 从 codeload 直接下 tarball，本市场实测可达，纯目录复制、不需要 Node。

方式 B（国内稳，本市场实测）：

# 来源: Trove 详细指南 · 验证于 2026-08-28
curl -sL https://codeload.github.com/addyosmani/agent-skills/tar.gz/refs/tags/0.6.7 | tar xz
cp -r agent-skills-0.6.7/skills ~/.claude/skills/agent-skills

预期输出: 无报错；~/.claude/skills/agent-skills/ 下出现 24 个技能目录

装好确认：

# 来源: Trove 详细指南 · 验证于 2026-08-28
ls ~/.claude/skills/agent-skills | wc -l

预期输出: 24

卡住怎么办：

• codeload 下载失败 → 换网络（校园网/代理切换）重试；或走方式 A skills CLI（npx -y skills add addyosmani/agent-skills --yes --global）；
• 技能没生效 → 确认复制到了 Agent 实际读取的技能目录（Claude Code 是 ~/.claude/skills/，其他 Agent 看各自约定）。

第 2 步：用斜杠命令触发工作流

为什么用斜杠命令：斜杠命令是生命周期入口——/spec 需求→规格（Spec before code）、/plan 规格→原子任务、/build 增量实现（/build auto 一键规划+实现）、/test 测试即证据、/review 合并前审查、/ship 上线。

# 来源: Trove 详细指南 · 验证于 2026-08-28
/spec    # 需求→规格（Spec before code）
/plan    # 规格→原子任务
/build   # 增量实现（/build auto 一键规划+实现）
/test    # 测试即证据
/review  # 合并前审查
/ship    # 上线

预期输出: 对应工作流激活（自动装载相关技能）

装好确认：

• 斜杠命令能唤起对应工作流（Agent 上下文出现技能提示）。

卡住怎么办：

• 命令不存在 → 确认技能目录已就位（第 1 步）；Claude Code 需重启会话让技能目录生效。

第 3 步：技能自动激活（无需手动命令）

讲解：设计 API 时自动激活 api-and-interface-design；改 UI 时激活 frontend-ui-engineering 等。这是「按任务自动装配」机制——技能不依赖手动触发。

# 来源: Trove 详细指南 · 验证于 2026-08-28
# 设计 API 时自动激活 api-and-interface-design；改 UI 时激活 frontend-ui-engineering 等

预期输出: agent 上下文自动注入对应技能

装好确认：

• 相关任务提示里出现技能引用。

卡住怎么办：

• 没自动激活 → 检查技能目录命名与 SKILL.md 格式是否符合 Agent 约定（各 Agent 略有差异）。

与工具页矩阵同源，共 19 对（3 实测兼容 / 14 推断可能兼容 / 2 推断可能冲突）；完整对子、状态与证据见 冲突对子（共装矩阵）。

• 暂无独立排障手册；安装/卸载问题先看 Agent 执行版 guide 注意事项

# 来源: Trove 详细指南 · 验证于 2026-08-28
rm -rf ~/.claude/skills/agent-skills .claude/skills/agent-skills; npx -y skills remove addyosmani/agent-skills 2>/dev/null || true

• 运行环境预检（需 Node >= 18；或直接手工复制技能目录）
• 官方快速路径 = skills CLI（vercel-labs/skills）；本环境 GitHub clone 慢，结构确认走 codeload tarball
• 每条操作 = 一个命令块 + 预期输出；斜杠命令在 Claude Code 类环境用 /命令 触发
• 技能目录删除（按实际安装位置）；斜杠命令按需清理
• 共享写面：技能装在 ~/.claude/skills 或项目 .claude/skills——与 superpowers 同面，同装需注意技能命名冲突（本市场判定 possible-conflict）

• 问：装完没生效？答：确认技能目录就位（ls 数 24），Claude Code 需重启会话；其他 Agent 看各自技能目录约定。
• 问：方式 A 和方式 B 选哪个？答：官方推荐 A（skills CLI，70+ agent 兼容）；国内 GitHub 慢时 B（codeload tarball，本环境结构确认）更稳。
• 问：和 superpowers 一起装会覆盖吗？答：目录名不同（agent-skills vs superpowers），互不覆盖；都放 ~/.claude/skills/ 下并存。
• 问：使用问题向谁反馈？答：本市场安装/卸载问题走条目反馈入口；项目自身问题请向作者仓库反馈。

• 版本：[0.6.7, 0.6.7] 锁定（收录结构确认版本）。
• 环境：方式 A 需要 Node >= 18（skills CLI）；方式 B 无运行时依赖（纯目录复制）。
• 网络：GitHub clone 慢（实测），codeload tarball 可达（实测）。
• 写面：~/.claude/skills/agent-skills/（与 superpowers 同面，装多个技能包注意目录规划）。

• 条目签名：addyosmani/agent-skills（MIT，原样收录 0.6.7）

• 实测：实测记录（本地留存）（2026-08-28，codeload tarball 结构确认 + 24 技能就位）。
• 未实测：方式 A skills CLI 安装（官方推荐路径，命令来自官方文档）；斜杠命令与自动激活（需 Claude Code 登录环境）。

第三方教学未逐条实测，仅供学习；有出入以本页与官方文档为准。

• 博客园：40 个 Agent Skills 精选资源（入门教程 + 实用工具 + 必装推荐）——程序员鱼皮 [博客园 · 程序员鱼皮 · 2026-02-12]
  Agent Skills 生态导航——入门教程（鱼皮保姆级视频/吴恩达×官方课程）、安装管理工具（skills CLI 用法 `npx skills add <owner/repo>`、Skill Seeker 文档转技能、everything-claude-code 配置合集）、推荐安装的技能包（planning-with-files 等）
• 官方仓库 README + 实测：skills CLI 安装布局（与 guide 预期输出对照） ⚠ 与实测冲突，以 Trove 实测为准 [官方文档 · agent-skills 官方 · 2026-08-30（guide 收录版本 0.6.7）]
  官方 skills CLI 安装链路 `npx -y skills add addyosmani/agent-skills --yes --global`（guide 方式 A）——装 24 个工程技能（define/plan/build/test/review/ship 全流程）