【Claude】npx skills 与 find-skills：Claude Code 技能生态完全指南

npx skills 与 find-skills：Claude Code 技能生态完全指南

概述

Claude Code 的 Skill 系统允许用户为 AI 安装"操作手册"，让它在处理特定类型任务时更精准。围绕这套系统，有两个关键角色：npx skills （CLI 包管理工具）和 find-skills（Claude 内的搜索代理 Skill）。

本文整理了两者的工作原理、核心区别，以及完整的安装使用流程。

什么是 Skill？

Skill = 你写给 AI 的一份"操作手册"，让它干某类活时不再瞎搞。

一个 Skill 就是一个文件夹，核心是 SKILL.md：

bash 复制代码

周报生成器/
├── SKILL.md        ← 核心！"手册"正文
├── scripts/        ← 可选：辅助脚本
└── references/     ← 可选：参考资料

SKILL.md 分两部分：

yaml 复制代码

---
name: weekly-report
description: 生成格式化周报。当用户提到周报、
  本周总结、工作汇报时使用此技能。
---

# 这里写具体指令
# 告诉 AI 怎么干活

三层加载机制

AI 的"注意力"有限，技能分三层加载以节省上下文：

层级	内容	加载时机
第1层	名字 + 简介（约100字）	永远在 AI 视野里
第2层	手册正文	触发技能时才加载（建议500行以内）
第3层	附带资料	需要时才去查，不限大小

类比：第1层是书脊上的书名，第2层是翻开书，第3层是书里的附录。

npx skills：底层 CLI 工具

npx skills 是一个基于 Node.js 的 CLI 工具，本质是针对 AI Agent 技能的包管理器，工作方式类似 npm/pip。

npx 这层干了什么？

bash 复制代码

npx skills find react
   ↓
npx 检查本地有没有 "skills" 这个包
   ↓
没有 → 临时从 npm registry 下载运行
有   → 直接运行

npx 不需要全局安装，直接运行远程包。

技能从哪来？

技能托管在 GitHub 上，格式是 owner/repo@skill-name：

bash 复制代码

npx skills add vercel-labs/agent-skills@react-best-practices

实际上是从 github.com/vercel-labs/agent-skills 仓库拉取对应 skill 文件夹。

安装到哪里？

bash 复制代码

# 全局安装（用户级别）
npx skills add xxx -g
# → 写入 ~/.claude/skills/

# 项目级别（不加 -g）
# → 写入 ./.claude/skills/

Claude Code 启动时自动扫描这些目录，把 skill 的 SKILL.md 注入上下文。

核心命令

bash 复制代码

npx skills find [关键词]   # 搜索技能
npx skills add <pkg> -g -y # 安装技能（-g 全局，-y 跳过确认）
npx skills check           # 检查哪些 skill 有新版本
npx skills update          # 拉取最新版本

完整安装链路

bash 复制代码

你运行 npx skills add xxx
        ↓
CLI 解析 owner/repo@skill 格式
        ↓
从 GitHub 拉取对应目录（含 SKILL.md）
        ↓
写入 ~/.claude/skills/xxx/SKILL.md
        ↓
下次启动 Claude Code 时自动加载
        ↓
Claude 在 system-reminder 里看到该技能的 description
        ↓
用户触发时 Claude 调用 Skill 工具执行

find-skills：Claude 内的搜索代理

find-skills 本身也是一个 Skill，它的作用是教会 Claude"如何帮用户搜索和安装其他 Skill"。

触发时机

你说这类话时会触发：

"有没有帮我做 XX 的插件/技能？"
"find a skill for XX"
"我想扩展 Claude 某方面的能力"

工作流程

bash 复制代码

理解需求 → 查排行榜 → CLI 搜索 → 验证质量 → 推荐给你 → （可选）帮你安装

第1步：查排行榜 先去 skills.sh 排行榜找热门技能，如装机量 10 万+ 的：

vercel-labs/agent-skills --- React/Next.js 相关
anthropics/skills --- 前端设计、文档处理

第2步：CLI 搜索 排行榜没有就执行：

bash 复制代码

npx skills find [关键词]

第3步：质量验证（重要）

指标	建议
装机量	≥ 1000 才算可信，< 100 需谨慎
来源	`vercel-labs`、`anthropics`、`microsoft` 更可信
GitHub 星数	< 100 星的仓库持怀疑态度

第4步：推荐 + 安装

找到合适的给你安装命令，也可直接帮你装：

bash 复制代码

npx skills add owner/repo@skill-name -g -y

找不到时怎么办？

直接用 Claude 自身能力完成任务
建议你自己创建：npx skills init my-skill-name

npx skills vs find-skills：核心区别

维度	`npx skills`	`find-skills`
是什么	Node.js CLI 工具	Claude Code 的 Skill
运行在哪	你的终端（shell）	Claude 的上下文里
执行者	你/脚本	Claude
交互方式	命令行输入输出	自然语言对话
质量筛选	无，搜到就显示	有，Claude 帮你评估
需要知道关键词	是	否，自然语言描述即可

共同点： 目标一致（找到并安装 skill），最终都调用同一个安装命令。

一句话总结：

bash 复制代码

find-skills = 教 Claude 怎么用 npx skills 帮你找技能的说明书
npx skills  = 实际干活的那把铲子

find-skills 是上层的智能代理，npx skills 是底层的执行工具。前者离不开后者，后者不需要前者。

find-skills 安装实战

搜索可用版本

bash 复制代码

npx skills find find-skills

输出（节选）：

bash 复制代码

vercel-labs/skills@find-skills     1.6M installs
skills.volces.com@find-skills      1.4K installs
modelscope.cn@find-skills          457 installs

安装（选装机量最高的）

bash 复制代码

npx skills add vercel-labs/skills@find-skills -g -y

安装位置：~\.agents\skills\find-skills，自动 symlink 到 Claude Code。

安全评估结果：Gen Safe / Socket 0 alerts / Snyk Med Risk。

使用方式

重启 Claude Code 后，直接用自然语言：

"有没有帮我写测试的技能？"
"find a skill for 代码审查"
"我想让 Claude 帮我自动写 changelog，有没有现成的？"

Claude 自动触发 find-skills → 搜索 → 评估 → 推荐 → 安装。

我们以frida相关skill为例，演示如何使用find-skills：我们也可以直接访问skills.sh网站查看frida相关技能：
注意： 当前对话不会立即生效，需要重新开一个对话才能加载新安装的 skill。

总结

场景	用什么
知道关键词，直接搜	`npx skills find xxx`
不知道叫什么，描述需求让 Claude 搜	对话触发 find-skills
确认要安装某个 skill	`npx skills add xxx -g -y`
管理已装的 skill	`npx skills check / update`

技能生态的本质是：GitHub 仓库 + npm 分发 + 约定好的目录结构 ，没有黑魔法，和任何包管理器的原理一样。find-skills 在此基础上加了一层自然语言理解和质量筛选，让"找到好的技能"这件事更省心。