find-skills 是 ClawHub 平台内置的核心工具，无需额外安装，专为 AI 代理/开发者设计，用于搜索、筛选、浏览、查看详情平台上所有可用的 AI 代理技能，快速匹配业务需求。

核心功能

1. 关键词精准搜索技能
2. 按分类/作者/标签筛选技能
3. 查看技能详情、用法、依赖
4. 列出平台全部可用技能

使用前提

• 已接入 ClawHub 平台/OpenClaw 工作区
• 无需配置 API 密钥、无需安装依赖（内置工具）

👤 作者：JimLiuxinghai
👉 Skills 下载地址：find-skills-0.1.0.zip

本技能可帮助你从开放式智能体技能生态中发现并安装技能。

何时使用本技能

当用户出现以下情况时使用本技能：

• 询问“我该如何做X”（其中X可能是有现成技能可完成的常见任务）
• 说“找一个能做X的技能”或“有没有能做X的技能”
• 询问“你能做X吗”（其中X是一项专业能力）
• 表达扩展智能体功能的意愿
• 想要搜索工具、模板或工作流
• 提及希望有人协助完成特定领域的工作（设计、测试、部署等）

什么是技能命令行工具（Skills CLI）？

技能命令行工具（npx skills）是开放式智能体技能生态的包管理器。技能是模块化的软件包，可通过专业知识、工作流和工具扩展智能体的能力。

核心命令：

## 交互式或按关键词搜索技能
npx skills find [查询关键词]
## 从GitHub或其他源安装技能
npx skills add <软件包名称>
## 检查技能更新
npx skills check
## 更新所有已安装的技能
npx skills update

浏览技能的地址： https://skills.sh/

如何帮助用户查找技能

步骤1：理解用户需求

当用户请求协助完成某项任务时，需明确：

1. 所属领域（例如：React、测试、设计、部署）
2. 具体任务（例如：编写测试用例、制作动画、审核PR）
3. 该任务是否足够常见，大概率已有对应的技能

步骤2：搜索技能

使用相关查询关键词运行查找命令：

## 执行技能查找命令，[查询关键词]需替换为实际搜索词
npx skills find [查询关键词]

示例：

• 用户问“我该如何让我的React应用更快？” → npx skills find react performance（React 性能优化）
• 用户问“你能帮我审核PR吗？” → npx skills find pr review（PR审核）
• 用户问“我需要创建更新日志” → npx skills find changelog（更新日志）

该命令会返回如下结果：

## 安装命令格式：npx skills add <仓库所有者/仓库名@技能名>
Install with npx skills add <owner/repo@skill>


vercel-labs/agent-skills@vercel-react-best-practices
└ https://skills.sh/vercel-labs/agent-skills/vercel-react-best-practices

步骤3：向用户展示结果

找到相关技能后，需向用户展示以下信息：

1. 技能名称及功能
2. 可执行的安装命令
3. 可在skills.sh查看详情的链接

示例回复：

我找到了一个可能对你有帮助的技能！"vercel-react-best-practices"（Vercel React最佳实践）技能提供了由Vercel工程团队制定的React和Next.js性能优化指南。


安装命令：
npx skills add vercel-labs/agent-skills@vercel-react-best-practices


了解更多：https://skills.sh/vercel-labs/agent-skills/vercel-react-best-practices

步骤4：主动提供安装协助

如果用户希望继续，你可以帮其安装该技能：

## -g 表示全局安装（用户级别），-y 跳过确认提示
npx skills add <仓库所有者/仓库名@技能名> -g -y

常见技能分类

搜索时可参考以下常见分类：

分类	示例查询关键词
前端开发	react, nextjs, typescript, css, tailwind
测试	testing, jest, playwright, e2e
开发运维（DevOps）	deploy, docker, kubernetes, ci-cd
文档编写	docs, readme, changelog, api-docs
代码质量	review, lint, refactor, best-practices
设计	ui, ux, design-system, accessibility
生产力工具	workflow, automation, git

高效搜索技巧

1. 使用具体关键词：“react testing”（React测试）比仅用“testing”（测试）效果更好
2. 尝试替代术语：如果“deploy”（部署）搜不到，可尝试“deployment”或“ci-cd”
3. 查看热门源：许多技能来自 vercel-labs/agent-skills 或 ComposioHQ/awesome-claude-skills

未找到技能时的处理方式

如果未找到相关技能：

1. 告知用户未找到匹配的现有技能
2. 提出可利用通用能力直接协助完成该任务
3. 建议用户可通过 npx skills init 创建自定义技能

示例：

我搜索了与“xyz”相关的技能，但未找到任何匹配结果。
不过我仍可以直接帮你完成这项任务！是否需要继续？


如果这是你经常要做的事，也可以创建自己的技能：
npx skills init my-xyz-skill

完整使用示例（命令 + 中文注释）

1. 基础搜索（关键词检索）

## 搜索包含「搜索」关键词的所有技能
find-skills search "搜索"


## 搜索包含「AI」「自动化」关键词的技能
find-skills search "AI 自动化"

2. 高级筛选（分类/作者筛选）

## 筛选指定作者发布的技能
find-skills by-author "JimLiuxinghai"


## 筛选指定分类的技能（工具类/自动化类/集成类）
find-skills by-category "工具"

3. 查看技能详情

## 查看指定技能的完整信息（用法、依赖、配置）
find-skills info "tavily-search"

4. 列出平台全部技能

## 列出 ClawHub 上所有公开可用的技能
find-skills list


## 列出全部技能并输出结构化 JSON 格式
find-skills list --json

5. 代码集成示例（AI 代理调用）

## 导入 ClawHub 技能搜索模块
from clawhub import FindSkillsClient


## 初始化技能搜索客户端（内置自动认证）
client = FindSkillsClient()


## 1. 执行关键词搜索
skills = client.search(query="网络搜索", max_results=10)


## 2. 遍历并打印搜索结果
for skill in skills:
    print(f"技能名称：{skill['name']}")
    print(f"技能描述：{skill['description']}")
    print(f"作者：{skill['author']}")
    print(f"访问链接：{skill['url']}\n")


## 3. 获取单个技能详情
skill_detail = client.get_skill_info("find-skills")
print("技能详情：", skill_detail)

命令参数说明

命令	作用	用法示例
search <关键词>	关键词搜索技能	find-skills search "自动化"
list	列出所有公开技能	find-skills list
by-author <作者名>	按作者筛选技能	find-skills by-author "arun-8687"
by-category <分类>	按分类筛选技能	find-skills by-category "集成"
info <技能名>	查看技能详细文档	find-skills info "gog"
--json	以JSON格式输出结果	find-skills list --json

使用注意事项

## 快速筛选高频技能
find-skills search "常用工具" --json


## 批量查看推荐技能
find-skills list | head -20

1. 内置工具：无需安装、无需配置环境变量，ClawHub 原生支持
2. 使用场景：AI 代理自主查找技能、开发者浏览可用插件、工作流搭建前筛选工具
3. 输出格式：支持普通文本/JSON 两种格式，JSON 可直接用于自动化集成
4. 更新同步：实时同步 ClawHub 平台最新上架的技能，无延迟

补充信息

• 官方地址：https://clawhub.ai/JimLiuxinghai/find-skills
• 类型：ClawHub 内置核心工具
• 适用平台：全平台（OpenClaw / Clawdbot / AI 代理）
• 核心优势：零配置、实时检索、支持筛选、可代码集成