如何用 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 CLInpx 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 CopilotVS 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识别到匹配任务时会先请求激活再加载完整指令。OpenCodeOpenCode 依次扫描以下路径项目级优先再全局.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.mdnpx skills默认落点.claude/skills/或共享位置通常能被上面两条路径之一覆盖。如果文件落在了 OpenCode 不扫描的位置复制或软链到发现路径例如skill-name替换为你实际安装的技能目录名如spec-driven-developmentmkdir -p .opencode/skills cp -r .claude/skills/skill-name .opencode/skills/判断标准每个技能目录里有一个SKILL.mdfrontmatter 含有效的name和description。详见 docs/opencode-setup.md。CursorCursor 只从.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/此时技能可能只是装在了个人作用域。对照安装输出确认实际路径想要项目级就重装到项目内。frontmattername必须存在且有效——它本身就是斜杠命令名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-skillsskills/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），仅供参考