如何用 npx skills 把 agent-skills 装进任意 AI 编码工具并验证技能被发现
【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills
如果你的 AI 编码工具（Claude Code、Cursor、Codex、Copilot、Cline、Gemini CLI 等）还没有一套固定的工程流程约束，agent-skills 提供了 25 个以SKILL.md为载体的技能（24 个生命周期技能加 1 个using-agent-skills元技能），把"先写 spec、测试先行、合并前审查"这类流程写进 agent 的上下文。这篇文章只讲一条路径：用开放的 skills CLI（npx skills add）把技能装进你的工具，然后确认工具确实发现了这些技能。README 说明该 CLI 可安装进 70+ agents，是跨工具的最快方式。
先明确这套路径给你什么、不给你什么：npx skills add addyosmani/agent-skills只安装技能本身，不会复制仓库里的短生命周期命令（/spec、/plan、/build、/test、/review、/ship）——那些是 Claude Code 专属命令，存放在.claude/commands/。在其他工具里要用技能的完整名字调用，例如/spec-driven-development，或者用自然语言指名技能。
安装前的准备
- 在一个目标项目的根目录下执行安装，让技能落入该项目的发现路径（
.claude/skills/、.agents/skills/等），而不是别处。 - 你的工具需要支持其中一种技能发现方式：有技能目录（Claude Code、Cursor、OpenCode、Gemini CLI、Copilot 等），或至少接受 Markdown 指令文件（任意 agent 都可以把
SKILL.md内容贴进 system prompt、rules 文件或对话，见 docs/getting-started.md 的通用流程）。
用 npx skills 安装
先浏览可安装的技能，不执行安装：
npx skills add addyosmani/agent-skills --list确认后安装整包（25 个技能）：
npx skills add addyosmani/agent-skills或者只装单个技能，--skill后面跟技能目录名。README 给出的示例：
npx skills add addyosmani/agent-skills --skill code-review-and-quality npx skills add addyosmani/agent-skills --skill test-driven-development安装位置由 CLI 决定：默认写入工具专属目录（通常是.claude/skills/或共享位置，如.agents/skills/）。如果你用全局/用户级标志运行，文件会写到工作区之外——看命令输出里给出的实际路径，后文的验证步骤依赖它。
验证技能被发现
不同工具的确认方式不同，选你用的那个即可。
GitHub Copilot（VS Code）
在 Copilot Chat 中运行/skills，打开Configure Skills菜单，确认哪些技能被发现且处于启用状态。每个安装的技能会变成一个以 frontmattername命名的斜杠命令——在聊天框输入/浏览本工作区实际加载的命令，应能看到/spec-driven-development、/test-driven-development这类完整技能名（而不是/spec）。
Gemini CLI
安装完成后在会话中运行：
/skills listGemini CLI 会自动发现.gemini/skills/或.agents/skills/下的SKILL.md，把技能名和描述注入 prompt，识别到匹配任务时会先请求激活再加载完整指令。
OpenCode
OpenCode 依次扫描以下路径（项目级优先，再全局）：
.opencode/skills/<name>/SKILL.md~/.config/opencode/skills/<name>/SKILL.md.claude/skills/<name>/SKILL.md~/.claude/skills/<name>/SKILL.md.agents/skills/<name>/SKILL.md~/.agents/skills/<name>/SKILL.md
npx skills默认落点（.claude/skills/或共享位置）通常能被上面两条路径之一覆盖。如果文件落在了 OpenCode 不扫描的位置，复制或软链到发现路径，例如（<skill-name>替换为你实际安装的技能目录名，如spec-driven-development）：
mkdir -p .opencode/skills cp -r .claude/skills/<skill-name> .opencode/skills/判断标准：每个技能目录里有一个SKILL.md，frontmatter 含有效的name和description。详见 docs/opencode-setup.md。
Cursor
Cursor 只从.cursor/skills/<skill-name>/SKILL.md加载项目技能，而npx skills默认不一定写这里。若技能不在该目录，按 docs/cursor-setup.md 从本地 clone 同步（rsync -a /path/to/agent-skills/skills/ .cursor/skills/）。验证分三步：
- Settings → Rules：项目
.mdc文件被列出（如果加了路由规则）； - Agent chat：
.cursor/skills/下的技能出现在技能列表中（视你的 Cursor 构建是否暴露该列表）； - 跑一个映射到技能的任务，不点名文件，例如 "add a feature with tests first"——路由正常时 agent 应主动打开
test-driven-development。
技能没被发现时按顺序检查
Copilot 文档给出一条排查顺序（/spec-driven-development这类完整技能名缺失时适用），其他工具同样适用前三条：
- 技能落在哪了：每个技能需要一个独立目录、内含
SKILL.md。用全局/用户级标志的安装器会写到工作区之外（如~/.agents/skills/），此时技能可能只是装在了个人作用域。对照安装输出确认实际路径，想要项目级就重装到项目内。 - frontmatter：
name必须存在且有效——它本身就是斜杠命令名；frontmatter 里关闭用户调用的技能不会出现在列表。 - 启用状态：在
/skills的 Configure Skills 菜单里确认该技能是启用的。 - 开新会话：新加的技能不总是能在对话中途被拾取。
- 宿主与版本：某些宿主（如 VS Code 的 Agent Host）行为不同，VS Code 与 Copilot 扩展过旧时先升级。
两个会踩到的限制
单技能安装拿不到references/。用--skill装单个技能时，CLI 只复制skills/<name>/目录，仓库根部的references/共享清单不在其中。技能本身可用，但技能内部指向共享清单的路径会失效。文档给出的对策：用整仓安装、git clone仓库，或把需要的清单复制进已安装技能目录下的references/（该可移植性问题跟踪在 issue #361）。
自然语言是兜底。即使斜杠命令不可用，任何 Copilot 界面、以及任何npx skills add安装过的 agent 都支持直接指名技能，例如：
Use the spec-driven-development skill to write a spec for [the feature].
Use the code-review-and-quality skill to review my staged changes.
验证通过之后
- 首次使用时先加载元技能
using-agent-skills（skills/using-agent-skills/SKILL.md），它包含一张把任务类型映射到对应技能的工作流程图，是发现入口。 - 按需加载，不要一次灌入全部技能——docs/getting-started.md 的推荐起步组合是三个：
spec-driven-development（定义做什么）、test-driven-development（证明它工作）、code-review-and-quality（合并前质量门）。 - 要把它铺到真实项目上（绿地全流程或既有代码库的渐进式推广），继续读 docs/adoption-guide.md。
【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
