Skills CLI 速用手册

一句话定位skills是 Agent Skills 的命令行管理器用来发现、安装、临时使用、更新和移除可复用的 agent 能力包。高频命令需求命令搜索 skillnpx skills find typescript查看仓库 skillsnpx skills add owner/repo --list安装指定 skillnpx skills add owner/repo --skill skill-name安装到 Codexnpx skills add owner/repo --skill skill-name -a codex全局安装npx skills add owner/repo --skill skill-name -g -y临时使用不落盘npx skills use owner/reposkill-name临时启动 Codexnpx skills use owner/reposkill-name --agent codex查看已安装npx skills ls更新npx skills update删除npx skills rm skill-nameSource 写法# GitHub 简写npx skillsaddvercel-labs/agent-skills# GitHub URL / Git URL / 本地路径npx skillsaddhttps://github.com/vercel-labs/agent-skills npx skillsaddgitgithub.com:vercel-labs/agent-skills.git npx skillsadd./my-local-skills# 单个 skillnpx skillsaddowner/reposkill-name npx skills use owner/reposkill-name# 指定分支或标签npx skillsaddowner/repo#mainnpx skillsaddowner/repo#v1.2.0npx skillsaddowner/repo#mainskill-nameadd安装npx skillsaddsource[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-skillsweb-design-guidelines npx skills use vercel-labs/agent-skillsweb-design-guidelines|claude npx skills use vercel-labs/agent-skillsweb-design-guidelines--agentcodex npx skills use vercel-labs/agent-skillsweb-design-guidelines/tmp/skill-prompt.txt[!warning]skills use --agent目前只支持claude-code和codex。其他 agent 用 stdout prompt 自行接入。多 skill 仓库必须指定 skillnpx skills use vercel-labs/agent-skills--skillweb-design-guidelines npx skills use vercel-labs/agent-skillsweb-design-guidelines其他命令命令用法findnpx skills find、npx skills find react performancelist/lsnpx skills ls、npx skills ls -g、npx skills ls -a codex、npx skills ls --jsonupdatenpx skills update、npx skills update my-skill、npx skills update -g、npx skills update -p、npx skills update -yremove/rmnpx skills rm my-skill、npx skills remove --global my-skill、npx skills remove --agent claude-code cursor my-skillupdate别名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参数名项目路径全局路径Codexcodex.agents/skills/~/.codex/skills/Claude Codeclaude-code.claude/skills/~/.claude/skills/OpenCodeopencode.agents/skills/~/.config/opencode/skills/Cursorcursor.agents/skills/~/.cursor/skills/Gemini CLIgemini-cli.agents/skills/~/.gemini/skills/GitHub Copilotgithub-copilot.agents/skills/~/.copilot/skills/项目级安装会维护skills-lock.json全局安装会维护用户级.skill-lock.json。安装方式方式适合场景Symlink默认推荐多个 agent 指向同一份 skill方便更新Copy不支持符号链接或希望各 agent 独立修改强制复制npx skillsaddowner/repo--copy相关链接vercel-labs/skillsSkills DirectoryAgent Skills SpecificationCodex Skills DocumentationClaude Code Skills DocumentationOpenCode Skills Documentation