广告位联系
返回顶部

skills.sh(npx skill)的使用介绍

Ai 来源:互联网 作者:佚名 发布时间:2026-10-16 21:21:28 人浏览
摘要

一、npx skills 是什么 npx skills 是 Vercel 推出的 AI Agent 技能管理工具,让 AI 编程助手(Claude Code、Cursor、Windsurf 等)获得专业能力。它就像 AI 助手的应用商店,一次安装,多个助手共享。 技能市

一、npx skills 是什么

npx skills 是 Vercel 推出的 AI Agent 技能管理工具,让 AI 编程助手(Claude Code、Cursor、Windsurf 等)获得专业能力。它就像 AI 助手的"应用商店",一次安装,多个助手共享。

  • 技能市场:https://skills.sh/
  • CLI 源码:https://github.com/vercel-labs/skills

二、核心概念

概念 说明 示例
技能包 GitHub 仓库,包含多个技能 obra/superpowers、vercel-labs/agent-skills
技能 具体的技能项,从技能包中选取安装 test-driven-development、frontend-design

结构关系(以 obra/superpowers 为例):

1

2

3

4

5

obra/superpowers(技能包/仓库)

├── test-driven-development(技能 1)

├── systematic-debugging(技能 2)

├── verification-before-completion(技能 3)

└── ...

三、第一次使用 npx skills

第一次运行 npx skills 命令时,npx 会提示你是否下载 skills 工具包。输入 y 确认即可,之后 npx 会缓存这个包。

四、技能安装详解

来源格式

npx skills add <仓库来源>

格式 示例
GitHub 短名 vercel-labs/agent-skills
GitHub URL https://github.com/vercel-labs/agent-skills
本地路径 ./my-skills

(1)查看仓库有哪些技能

安装前先看看某个仓库里有哪些技能可选:

1

npx skills add vercel-labs/agent-skills --list

(2)安装技能

方式 A:安装整个技能包

安装某个仓库包含的所有技能:

1

2

3

4

# 安装 obra/superpowers 的所有技能

npx skills add obra/superpowers

# 安装 vercel-labs/agent-skills 的所有技能

npx skills add vercel-labs/agent-skills

方式 B:安装指定技能

从仓库中只安装特定的一个或多个技能:

1

2

3

4

5

6

7

8

9

10

11

# 安装单个技能

npx skills add vercel-labs/agent-skills -s frontend-design

 

# 安装多个指定技能

npx skills add vercel-labs/agent-skills -s frontend-design -s skill-creator

 

# 安装带空格的技能名(必须加引号)

npx skills add owner/repo --skill "Convex Best Practices"

 

# 安装所有技能到指定助手

npx skills add vercel-labs/agent-skills --skill '*' -a claude-code

方式 C:非交互式安装

建议先使用交互式安装熟悉流程后再使用此方式

使用 -y 跳过确认,-g 全局安装,-a 指定助手:

1

2

3

4

5

# 全局安装到指定助手,跳过确认

npx skills add vercel-labs/agent-skills -a claude-code -g -y

 

# 安装指定技能,跳过确认

npx skills add vercel-labs/agent-skills -s frontend-design -y

五、快速开始(整个交互流程)

以 obra/superpowers 仓库举例

运行 npx skills add obra/superpowers后,CLI 会依次询问:

流程一:选择要安装的技能

  1. 空格:单独勾选/取消当前这一个技能
  2. a:一键全选全部技能
  3. u:一键清空所有勾选(全部取消选中)
  4. i:反向颠倒勾选(选中变不选,不选变选中)
  5. 回车:确认勾选,开始批量安装

流程二:选择安装到哪个 AI 助手

按照你的选择安装到相应的AI目录里面去(支持多选)
当然如果没有找到的话,也可以不勾选(因为会默认创建一个.agents文件夹)

AGENT SKILLS 路径 项目指令文件
Claude Code ~/.claude/skills/ CLAUDE.md
Qwen Code ~/.qwen/skills/ QWEN.md / AGENTS.md
OpenCode ~/.agents/skills/ AGENTS.md
GitHub Copilot - .github/copilot-instructions.md
Gemini CLI - GEMINI.md

流程三:选择安装范围

选项 说明
Project(项目级) 安装到当前项目,随 Git 提交,团队共享
Global(全局级) 安装到用户目录,所有项目可用

流程四:选择安装方式

选项 说明
Symlink(符号链接) 推荐,更新一处同步所有
Copy(复制) 独立副本

六、其他常用命令

第一部分:项目级安装(仅影响当前目录)

默认操作范围是当前项目,所有命令不加 -g。

1?? 搜 – 查找可安装的技能find

1

2

npx skills find               # 交互式浏览搜索,上下键选择,回车即装

npx skills find react         # 按关键词搜索(如 react、pdf、api)

2?? 增 – 添加/安装技能add

1

2

3

4

npx skills add frontend-design               # 安装单个技能

npx skills add obra/superpowers --skill brainstorming --skill writing-plans -y   # 从仓库装多个技能

npx skills add <技能名> --copy               # 使用复制模式(不建立软链接)

npx skills add <技能名> -a claude-code       # 只给指定的 AI 助手安装

3?? 查 – 查看已安装的技能list

1

2

npx skills list                # 列出当前项目所有已安装的技能

npx skills list -a cursor      # 只列出某个 AI 助手(cursor)下的技能

4?? 改 – 更新技能update/check

1

2

3

npx skills check               # 检查有哪些技能可以更新(不实际更新)

npx skills update              # 更新当前项目的所有技能

npx skills update frontend-design    # 只更新指定的技能

5?? 删 – 卸载技能remove(别名rm)

1

2

3

4

5

npx skills remove              # 交互式选择卸载(空格多选,回车确认)

npx skills remove frontend-design     # 直接卸载指定技能

npx skills remove brainstorming writing-plans   # 同时卸载多个

npx skills remove --all        # ?? 删除当前项目的所有技能(危险)

npx skills remove frontend-design -y   # 静默卸载,不询问

第二部分:全局级安装(影响所有项目)

全局安装的技能对所有项目都生效。所有命令都必须加上 -g 参数。

1?? 搜 – 查找可安装的技能find

1

2

npx skills find               # 交互搜索,之后安装时会提示选择范围,选 global

npx skills find python        # 关键词搜索

注意:find 本身不区分项目/全局,但安装时可通过提示选择。若想直接装到全局,请用下面的 add -g。

2?? 增 – 添加/安装技能到全局add -g

1

2

3

4

npx skills add frontend-design -g           # 全局安装单个技能

npx skills add obra/superpowers --skill brainstorming --skill writing-plans -g -y   # 从仓库安装多个全局技能

npx skills add <技能名> -g --copy           # 使用复制模式全局安装

npx skills add <技能名> -g -a cursor        # 只给全局中的某个 AI 助手安装

3?? 查 – 查看全局已安装的技能list -g

1

2

npx skills list -g                # 列出所有全局安装的技能

npx skills list -g -a claude-code # 只列出全局中 Claude Code 的技能

4?? 改 – 更新全局技能update -g/check -g

1

2

3

npx skills check -g               # 检查哪些全局技能有更新

npx skills update -g              # 更新所有全局技能

npx skills update frontend-design -g   # 只更新某个指定的全局技能

5?? 删 – 卸载全局技能remove -g

1

2

3

4

5

npx skills remove -g              # 交互式选择卸载全局技能(空格多选)

npx skills remove frontend-design -g     # 直接卸载指定的全局技能

npx skills remove brainstorming writing-plans -g   # 同时卸载多个全局技能

npx skills remove --all -g        # ?? 删除所有全局技能(极度危险)

npx skills remove frontend-design -g -y   # 静默卸载

七、推荐技能包

Superpowers(AI 工作流)

1

npx skills add obra/superpowers

包含技能:

  • test-driven-development:测试驱动开发
  • systematic-debugging:系统化调试
  • verification-before-completion:完成前验证

Vercel 官方技能包

1

npx skills add vercel-labs/agent-skills

包含技能:

  • vercel-react-best-practices:React 最佳实践
  • web-design-guidelines:Web 设计规范
  • skill-creator:技能开发指南

Anthropic 官方技能包

1

npx skills add anthropics/skills

包含技能:

  • frontend-design:前端设计
  • pdf:PDF 处理

八、常见问题

Q1: 第一次运行很慢?

首次运行时 npx 需要下载 skills 包,之后会使用缓存。

Q2: 安装太多技能会怎样?

AI 启动时需要加载技能元数据,安装太多会影响响应速度。建议只安装常用的。

Q3: 安装后 AI 没有用到技能?

  1. 重启 AI 助手
  2. 运行 npx skills list 确认安装成功
  3. 检查技能是否安装到正确目录

Q4: 团队如何共享技能?

  1. 项目级安装(不加 -g)
  2. 把 skills-lock.json 提交到 Git
  3. 团队成员拉取后运行 npx skills add

Q5: 如何禁用遥测?

1

export DISABLE_TELEMETRY=1

九、命令速查表

命令 作用
npx skills add <仓库> --list 查看仓库有哪些技能
npx skills add <仓库> 安装整个技能包
npx skills add <仓库> -s 技能名 安装指定单个技能
npx skills add <仓库> -s 技能1 -s 技能2 安装多个指定技能
npx skills add <仓库> -s 技能名 -y 非交互式安装
npx skills list 查看已安装技能
npx skills find <关键词> 搜索技能
npx skills update 更新所有技能
npx skills update <技能名> 更新指定技能
npx skills remove <技能名> 卸载技能
npx skills check 检查更新

版权声明 : 本文内容来源于互联网或用户自行发布贡献,该文观点仅代表原作者本人。本站仅提供信息存储空间服务和不拥有所有权,不承担相关法律责任。如发现本站有涉嫌抄袭侵权, 违法违规的内容, 请发送邮件至2530232025#qq.cn(#换@)举报,一经查实,本站将立刻删除。
原文链接 :
相关文章
  • 本站所有内容来源于互联网或用户自行发布,本站仅提供信息存储空间服务,不拥有版权,不承担法律责任。如有侵犯您的权益,请您联系站长处理!
  • Copyright © 2017-2022 F11.CN All Rights Reserved. F11站长开发者网 版权所有 | 苏ICP备2022031554号-1 | 51LA统计