Quartz 4

🔍 搜索

find-skills深度调研报告

16 min read

find-skills 深度调研报告

先别急着造轮子，先学会找轮子。

调研日期：2026-04-22

一、find-skills 是什么？解决什么问题？

1.1 痛点

Claude Code 的 Skill 生态已经爆发式增长（skills.sh 收录 90,000+ skills），但大多数人 Skill 装得少，不是没需求，而是不知道有现成的能用。发现 skill 的方式还停留在”人工翻 awesome list”的阶段。

1.2 find-skills 的定位

find-skills 是一个”元技能”（meta-skill）——它不做具体业务，而是帮你搜索、发现、安装其他 skill。相当于 skill 世界的”应用商店搜索栏”。

核心能力：

  • 接收自然语言描述（“帮我找个做 PR review 的 skill”）
  • 调用 npx skills find CLI 搜索 skills.sh 生态
  • 展示结果（名称、来源、安装命令）
  • 确认后一键安装到 .claude/skills/

二、两个实现版本的详细对比

目前 GitHub 上有两个主要的 find-skills 实现：

维度CherryHQ/cherry-studiohaha0815/claude-meta-skills
仓库CherryHQ/cherry-studiohaha0815/claude-meta-skills
文件路径resources/skills/find-skills/SKILL.mdfind-skills/SKILL.md
文件大小6167 bytes（更完整）4635 bytes（更精简）
项目背景Cherry Studio 桌面 AI 应用的内置 skill独立的 Claude Code 元技能合集
配套 skills仅 find-skills5 个配套：find-skills / skill-auditor / skills-updater / skillshare / ideation

2.1 功能覆盖对比

功能点CherryHQ 版haha0815 版
触发条件描述相同相同
Skills CLI 命令介绍相同相同
Step 1: 理解用户需求相同相同
Step 2: 搜索 skills相同相同
Step 3: 展示结果展示名称 + 源码链接 + 安装命令展示名称 + 安装命令 + skills.sh 链接
Step 4: 安装流程有完整安全审查流程直接问是否安装
运行时兼容有 npx → bun fallback仅 npx
安全警告有专门章节无
安装方式npx skills add <pkg> -y（项目级）npx skills add <pkg> -g -y（全局）
分类参考表相同相同
搜索技巧相同相同
无结果兜底相同相同

2.2 核心差异详解

差异一：安全审查（最重要的区别）

CherryHQ 版在安装前要求三步确认：

1. 展示安全警告：skill 是第三方代码，可以读写删文件
2. 提供源码链接让用户自行审查 SKILL.md 和脚本
3. 等用户明确说 "yes" 才执行安装

haha0815 版跳过了这些，直接 npx skills add <pkg> -g -y。

为什么这很重要？ Skill 可以执行任意代码，拥有 agent 的全部权限（读写文件、运行 shell 命令、网络请求）。一个恶意 skill 可以：

  • 读取你的 SSH key、环境变量、API key
  • 修改或删除项目文件
  • 向外部服务器发送数据

差异二：安装范围

CherryHQ 版haha0815 版
命令npx skills add <pkg> -ynpx skills add <pkg> -g -y
范围当前项目（.claude/skills/）全局（~/.claude/skills/）
影响仅当前项目可用所有项目都能用

全局安装（-g）更方便但风险更高——一个有问题的 skill 会影响你所有项目。

差异三：运行时兼容

CherryHQ 版多了一段 Cherry Studio 桌面应用的 bun runtime fallback：

# 先检查 npx
which npx
# 不存在则用 Cherry Studio 内置的 bun
if [ -n "$CHERRY_STUDIO_BUN_PATH" ] && [ -x "$CHERRY_STUDIO_BUN_PATH" ]; then
  "$CHERRY_STUDIO_BUN_PATH" x skills find react
fi

对于纯 Claude Code CLI 用户来说，这段代码没用。

2.3 推荐结论

推荐以 CherryHQ 版为基础，理由：

  1. 安全审查流程完整——第三方 skill 确实有风险
  2. 展示源码链接而非仅 skills.sh 链接——方便直接审查代码
  3. 需要做两处适配：去掉 bun fallback（不需要）、加上 -g 全局安装选项（按需）

三、推荐版本能干什么？实际应用举例

3.1 核心工作流

用户提出需求 → find-skills 理解意图 → 搜索 skills.sh → 展示结果 → 用户确认 → 安装

3.2 六个真实使用场景

场景 1：React 项目优化

用户：我的 React 项目渲染太慢了，有没有什么 skill 能帮忙？

→ find-skills 执行：npx skills find react performance

→ 返回结果：
  vercel-labs/agent-skills@vercel-react-best-practices
  └ React & Next.js 性能优化最佳实践（来自 Vercel 官方工程团队）
  └ 12.9k installs

→ 安装：npx skills add vercel-labs/agent-skills@vercel-react-best-practices -y

安装后，Claude 在你的 React 项目中会自动获得 Vercel 工程团队总结的性能优化知识，包括 code splitting、lazy loading、memoization 策略等。

场景 2：PR Review 自动化

用户：有没有帮我做 code review 的 skill？

→ find-skills 执行：npx skills find pr review

→ 返回结果：
  anthropics/skills@code-review
  └ 官方代码审查 skill

→ 安装后 Claude 会按照结构化的 checklist 审查你的代码

场景 3：Supabase 后端开发

用户：我在用 Supabase，有最佳实践的 skill 吗？

→ find-skills 执行：npx skills find supabase

→ 返回结果：
  supabase/agent-skills@supabase-best-practices
  └ Supabase 官方最佳实践（30.2k installs）

→ 安装后 Claude 了解 Supabase 的 RLS 策略、Edge Functions 模式、Auth 配置等

场景 4：Playwright 端到端测试

用户：帮我写 E2E 测试，有啥工具？

→ find-skills 执行：npx skills find playwright e2e

→ 返回多个结果：
  anthropics/skills@webapp-testing        ← 官方 Playwright skill
  lackeyjb/playwright-skill              ← 社区通用浏览器自动化

→ 用户选择安装一个或多个

场景 5：创建 Changelog

用户：我想自动生成 changelog，有 skill 吗？

→ find-skills 执行：npx skills find changelog

→ 如果找到：展示结果供安装
→ 如果没找到：
  "没有找到 changelog 相关的 skill。我可以直接帮你做，
   或者你可以创建自己的 skill：npx skills init my-changelog-skill"

场景 6：安全渗透测试

用户：我在做安全审计，有 skill 帮忙吗？

→ find-skills 执行：npx skills find security audit

→ 返回结果：
  trailofbits/skills@codeql-analysis
  └ Trail of Bits 安全团队出品：CodeQL/Semgrep 静态分析、变体分析、漏洞检测

3.3 社区实际采用情况

采用方使用方式来源
CherryHQ/cherry-studio作为桌面应用内置 skill，开箱即用GitHub
haha0815/claude-meta-skills独立元技能合集，与 skill-auditor 等配套GitHub
briascoi/skillgrab进化版：自动扫描项目 → 推荐 → 批量安装GitHub
sonofmagic/weapp-tailwindcss在项目文档中推荐用 npx skills add 安装 skillGitHub

四、进化版：skillgrab（自动推荐）

如果说 find-skills 是”搜索栏”，那 skillgrab 就是”智能推荐引擎”。

4.1 与 find-skills 的对比

find-skillsskillgrab
自动检测技术栈不支持（需手动输入关键词）自动扫描 package.json / requirements.txt 等
读 README 推荐非代码 skill不支持支持（营销/SEO/设计等）
GitHub 验证不验证验证 SKILL.md 真实存在
去重不去重自动去重
多 agent 同时安装不支持同时装到 Claude Code / Cursor / Cline 等
状态 / 更新管理不支持status + update 子命令
可信来源过滤不支持--only-trusted 白名单
MCP Server不支持支持（可在 chat 中直接调用）

4.2 skillgrab 实际运行效果

$ npx skillgrab
 
  skillgrab v0.5.0
 
▸ Tech signals
  next.js            package.json → next
  tailwind           package.json → tailwindcss
  supabase           package.json → @supabase/supabase-js
  stripe             package.json → stripe
 
▸ Install plan
  ★ vercel-labs/agent-skills/find-skills          ← next.js    12.9k installs
  ★ supabase/agent-skills/supabase-best-practices ← supabase   30.2k installs
  ★ stripe/ai/stripe-best-practices               ← stripe      5.1k installs
 
▸ Detected agents: claude-code, cursor
 
  Installing to: claude-code, cursor
  ✔ Installed 3 skills.

4.3 skillgrab 关键命令

npx skillgrab                          # 扫描项目，交互式安装
npx skillgrab --dry-run                # 预览，不实际安装
npx skillgrab --only-trusted           # 仅安装可信来源（anthropics/vercel/supabase 等）
npx skillgrab status                   # 查看已安装 skills 状态
npx skillgrab update                   # 更新所有 skills
npx skillgrab --agent claude-code      # 指定目标 agent

五、手把手教程：如何使用 find-skills

5.1 方式一：直接使用 Skills CLI（最轻量）

不需要安装任何 skill，直接用 CLI：

# 搜索
npx skills find react performance
npx skills find testing playwright
npx skills find code review
 
# 安装（项目级）
npx skills add vercel-labs/agent-skills@vercel-react-best-practices -y
 
# 安装（全局，所有项目可用）
npx skills add vercel-labs/agent-skills@vercel-react-best-practices -g -y
 
# 检查更新
npx skills check
 
# 更新所有
npx skills update
 
# 创建自己的 skill
npx skills init my-cool-skill

浏览网站：https://skills.sh/

5.2 方式二：安装 find-skills Skill（推荐）

将 find-skills 作为 Claude Code 的 skill 安装后，Claude 会自动识别你的需求并调用搜索，不需要你手动敲 npx 命令。

安装步骤：

# 1. 创建 skill 目录
mkdir -p ~/.claude/skills/find-skills
 
# 2. 下载 SKILL.md（使用 CherryHQ 推荐版本）
curl -fsSL https://raw.githubusercontent.com/CherryHQ/cherry-studio/main/resources/skills/find-skills/SKILL.md \
  -o ~/.claude/skills/find-skills/SKILL.md
 
# 3. 验证
cat ~/.claude/skills/find-skills/SKILL.md | head -5

安装后的效果：

你在 Claude Code 中说任何类似这些话，find-skills 就会自动触发：

  • “有没有做 X 的 skill？”
  • “帮我找个 Y 的工具”
  • “我想扩展 Z 的能力”
  • “can you do X?”

Claude 会自动搜索 → 展示结果 → 等你确认 → 安装。

5.3 方式三：安装 skillgrab（全自动推荐）

适合新项目快速配置：

# 进入你的项目目录
cd /path/to/your/project
 
# 预览推荐（不安装）
npx skillgrab --dry-run
 
# 仅安装可信来源
npx skillgrab --only-trusted
 
# 全部安装
npx skillgrab

配置为 MCP Server（可以在 Claude 对话中直接调用）：

// ~/.claude/settings.json 中添加
{
  "mcpServers": {
    "skillgrab": {
      "command": "npx",
      "args": ["skillgrab-mcp"]
    }
  }
}

5.4 方式四：浏览 Awesome Lists（手动发现）

当 CLI 搜不到时，去这些策展仓库翻：

仓库特点链接
awesome-claude-code最全面（74K README），涵盖 skills/hooks/agents/pluginsGitHub
awesome-claude-skills专注 Skills，含官方+社区，结构清晰GitHub
awesome-skills跨平台（Claude Code / Codex / Gemini CLI），56K READMEGitHub
awesome-agent-skills跨 agent 平台策展GitHub

六、安全注意事项

Skill = 可执行代码。安装一个 skill 等于授予它 agent 的全部权限。

6.1 安装前必须做的

  1. 查看源码：检查 SKILL.md 和 scripts/ 目录下的所有脚本
  2. 确认来源：优先安装可信来源（anthropics / vercel / supabase / stripe 等官方仓库）
  3. 项目级安装：对不确定的 skill 先用项目级安装（不加 -g），限制影响范围

6.2 可信来源白名单

skillgrab 维护了一个白名单（--only-trusted 使用）：

anthropics, vercel, vercel-labs, supabase, stripe, clerk,
openai, microsoft, github, google, cloudflare, apify, openclaudia

6.3 元技能配套

如果你安装了 haha0815/claude-meta-skills 的全套，还能用：

Skill功能
skill-auditor审计已安装 skill 的质量和安全性
skills-updater批量更新已安装的 skill
skillshare打包分享你自己的 skill
ideation帮你构思新 skill 的创意

七、总结：选哪个？

你的需求推荐方案
偶尔找找有没有现成 skill直接 npx skills find <关键词>
希望 Claude 自动帮我搜索安装 find-skills skill（CherryHQ 版）
新项目快速配齐 skillsnpx skillgrab --only-trusted
全面的 skill 生命周期管理安装 haha0815/claude-meta-skills 全套
手动翻阅发现灵感浏览 awesome-claude-code 仓库

一句话总结：find-skills 就是 skill 生态的 apt/brew/npm search —— 先搜再装，别自己从头写。

八、实测验证记录（2026-04-22）

以下是在本机实际安装和运行 find-skills 的完整记录。

8.1 环境信息

Node:  v22.12.0
npx:   10.9.0
OS:    Ubuntu 22.04 (Linux 6.8.0)
Shell: bash

8.2 安装过程

# 1. 创建目录
mkdir -p ~/.claude/skills/find-skills
 
# 2. 写入基于 CherryHQ 版适配的 SKILL.md（去掉 bun fallback，保留安全审查，加全局安装选项）
# 文件路径：~/.claude/skills/find-skills/SKILL.md
 
# 3. 验证安装
$ ls ~/.claude/skills/
find-skills  gitnexus-cli  gitnexus-debugging  gitnexus-exploring
gitnexus-guide  gitnexus-impact-analysis  gitnexus-refactoring

安装后重新进入 Claude Code 会话，系统 skill 列表中已出现：

- find-skills: Helps users discover and install agent skills when they ask
  questions like "how do I do X", "find a skill for X"...

8.3 实测搜索一：android perfetto

$ npx skills find android perfetto

返回结果：

Skill安装量说明
new-silvermoon/awesome-android-agent-skills@compose-performance-audit265Android Compose 性能审计
hardw00t/ai-security-arsenal@android-pentest32Android 渗透测试
desquared/agents-rules-skills@android-performance-profiler16Android 性能 profiler
meta-quest/agentic-tools@hz-perfetto-debug10Meta 出品的 Perfetto 调试 skill
krutikjain/android-agent-skills@android-performance-observability8Android 性能可观测性

8.4 实测搜索二：code review

$ npx skills find code review

返回结果：

Skill安装量说明
obra/superpowers@requesting-code-review57.3K最热门的 code review skill
wshobson/agents@code-review-excellence13.3K卓越代码审查
supercent-io/skills-template@code-review12.5K代码审查模板
github/awesome-copilot@sql-code-review9.5KSQL 代码审查
sanyuan0704/code-review-expert@code-review-expert6.2K代码审查专家

8.5 实测搜索三：typescript testing

$ npx skills find typescript testing

返回结果：

Skill安装量说明
bmad-labs/skills@typescript-e2e-testing1.8KTypeScript E2E 测试
bobmatnyc/claude-mpm-skills@vitest565Vitest 测试框架
bmad-labs/skills@typescript-unit-testing238TypeScript 单元测试
shinpr/claude-code-workflows@typescript-testing14TypeScript 测试工作流

8.6 安装 skill 示例

如果要安装上面搜到的某个 skill：

# 安装到当前项目（推荐，影响范围小）
npx skills add obra/superpowers@requesting-code-review -y
 
# 安装到全局（所有项目可用）
npx skills add obra/superpowers@requesting-code-review -g -y

安装后 skill 会出现在 .claude/skills/（项目级）或 ~/.claude/skills/（全局）目录中。

九、快速参考卡片

┌─────────────────────────────────────────────────────────┐
│                   find-skills 速查                       │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  搜索:   npx skills find <关键词>                        │
│  安装:   npx skills add <owner/repo@skill> -y           │
│  全局:   npx skills add <owner/repo@skill> -g -y        │
│  更新:   npx skills update                              │
│  检查:   npx skills check                               │
│  创建:   npx skills init <skill-name>                   │
│                                                         │
│  自动推荐: npx skillgrab --dry-run                       │
│  仅可信:   npx skillgrab --only-trusted                  │
│                                                         │
│  浏览:   https://skills.sh/                             │
│                                                         │
│  在 Claude Code 对话中直接说:                             │
│  "有没有做 X 的 skill？"  →  自动触发搜索                 │
│                                                         │
│  安全第一:                                               │
│  · 安装前查看源码                                        │
│  · 优先选可信来源（anthropics/vercel/supabase...）        │
│  · 不确定的 skill 先装项目级（不加 -g）                   │
│                                                         │
└─────────────────────────────────────────────────────────┘

Graph View