PCB缺陷检测：AI技术如何提升电子制造质量
2026/7/24 23:52:33
一句话定位
skills是 Agent Skills 的命令行管理器，用来发现、安装、临时使用、更新和移除可复用的 agent 能力包。
高频命令
| 需求 | 命令 |
|---|---|
| 搜索 skill | npx skills find typescript |
| 查看仓库 skills | npx skills add owner/repo --list |
| 安装指定 skill | npx skills add owner/repo --skill skill-name |
| 安装到 Codex | npx skills add owner/repo --skill skill-name -a codex |
| 全局安装 | npx skills add owner/repo --skill skill-name -g -y |
| 临时使用，不落盘 | npx skills use owner/repo@skill-name |
| 临时启动 Codex | npx skills use owner/repo@skill-name --agent codex |
| 查看已安装 | npx skills ls |
| 更新 | npx skills update |
| 删除 | npx skills rm skill-name |
Source 写法
# GitHub 简写npx skillsaddvercel-labs/agent-skills# GitHub URL / Git URL / 本地路径npx skillsaddhttps://github.com/vercel-labs/agent-skills npx skillsaddgit@github.com:vercel-labs/agent-skills.git npx skillsadd./my-local-skills# 单个 skillnpx skillsaddowner/repo@skill-name npx skills use owner/repo@skill-name# 指定分支或标签npx skillsaddowner/repo#mainnpx skillsaddowner/repo#v1.2.0npx skillsaddowner/repo#main@skill-nameadd安装
npx skillsadd<source>[options]别名：a、install、i。
| 参数 | 作用 |
|---|---|
-g,--global | 安装到全局用户目录 |
-a,--agent <agents...> | 指定目标 agent，如codex、claude-code、opencode |
-s,--skill <skills...> | 只安装指定 skill；'*'表示全部 |
-l,--list | 只列出可用 skills，不安装 |
-y,--yes | 跳过确认 |
--copy | 复制文件，而不是创建符号链接 |
--all | 全部 skills、全部 agents、自动确认 |
--full-depth | 深度搜索子目录中的SKILL.md |
常用例子：
npx skillsaddvercel-labs/agent-skills--listnpx skillsaddvercel-labs/agent-skills--skillfrontend-design npx skillsaddvercel-labs/agent-skills--skillfrontend-design-acodex npx skillsaddvercel-labs/agent-skills--skill'*'-aclaude-code npx skillsaddvercel-labs/agent-skills--alluse临时使用
skills use会下载所选 skill 到临时目录，输出可喂给 agent 的 prompt，不会安装到项目或全局目录。
npx skills use vercel-labs/agent-skills@web-design-guidelines npx skills use vercel-labs/agent-skills@web-design-guidelines|claude npx skills use vercel-labs/agent-skills@web-design-guidelines--agentcodex npx skills use vercel-labs/agent-skills@web-design-guidelines>/tmp/skill-prompt.txt[!warning]
skills use --agent目前只支持claude-code和codex。其他 agent 用 stdout prompt 自行接入。
多 skill 仓库必须指定 skill：
npx skills use vercel-labs/agent-skills--skillweb-design-guidelines npx skills use vercel-labs/agent-skills@web-design-guidelines其他命令
| 命令 | 用法 |
|---|---|
find | npx skills find、npx skills find react performance |
list/ls | npx skills ls、npx skills ls -g、npx skills ls -a codex、npx skills ls --json |
update | npx skills update、npx skills update my-skill、npx skills update -g、npx skills update -p、npx skills update -y |
remove/rm | npx skills rm my-skill、npx skills remove --global my-skill、npx skills remove --agent claude-code cursor my-skill |
update别名：upgrade、check。
删除全部或批量删除：
npx skills remove--allnpx skills remove--skill'*'-acursor npx skills remove my-skill--agent'*'Skill 文件最小结构
一个 skill 是带SKILL.md的目录。SKILL.md必须有 frontmatter：
--- name: my-skill description: What this skill does and when to use it --- ## Instructions 1. Do the task.推荐目录：
repo/ └── skills/ └── my-skill/ ├── SKILL.md ├── scripts/ ├── references/ └── assets/CLI 会扫描常见位置：
SKILL.md skills/ skills/.curated/ skills/.experimental/ skills/.system/ .agents/skills/ .claude/skills/ .codex/skills/如果SKILL.md藏得很深：
npx skillsaddowner/repo --full-depth安装位置
| Agent | 参数名 | 项目路径 | 全局路径 |
|---|---|---|---|
| Codex | codex | .agents/skills/ | ~/.codex/skills/ |
| Claude Code | claude-code | .claude/skills/ | ~/.claude/skills/ |
| OpenCode | opencode | .agents/skills/ | ~/.config/opencode/skills/ |
| Cursor | cursor | .agents/skills/ | ~/.cursor/skills/ |
| Gemini CLI | gemini-cli | .agents/skills/ | ~/.gemini/skills/ |
| GitHub Copilot | github-copilot | .agents/skills/ | ~/.copilot/skills/ |
项目级安装会维护skills-lock.json，全局安装会维护用户级.skill-lock.json。
安装方式：
| 方式 | 适合场景 |
|---|---|
| Symlink | 默认推荐；多个 agent 指向同一份 skill，方便更新 |
| Copy | 不支持符号链接，或希望各 agent 独立修改 |
强制复制：
npx skillsaddowner/repo--copy相关链接
- vercel-labs/skills
- Skills Directory
- Agent Skills Specification
- Codex Skills Documentation
- Claude Code Skills Documentation
- OpenCode Skills Documentation