skill-finder

技能查找器

从两个互补来源发现并安装 Agent 技能：

来源	覆盖范围	搜索	安装
ClawHub（clawhub.com）	精选注册表，带版本的程序包	向量语义搜索	npx clawhub install <slug>
AgentSkill.work	330 多个 GitHub 仓库，丰富的元数据	REST API 关键词 + 筛选条件	npx clawhub install 或 git clone

始终搜索两个来源——它们有重叠，但各自也有独特的技能。

工作流

1. 搜索

ClawHub——语义搜索能够理解意图（“管理我的任务”会找到待办事项技能）：

npx clawhub search "<query>" --limit 10

AgentSkill.work——带筛选条件的关键词搜索：

# By keyword
curl -s "https://agentskill.work/api/skills?q=<query>&limit=10&sort=stars"

# By topic (GitHub topic tag)
curl -s "https://agentskill.work/api/skills?topic=<topic>&limit=10&sort=stars"

# By language
curl -s "https://agentskill.work/api/skills?language=Python&limit=10&sort=stars"

# Combined filters
curl -s "https://agentskill.work/api/skills?q=<query>&topic=<topic>&language=<lang>&limit=10&sort=stars"

解析结果：

curl -s "<url>" | python3 -c "
import sys, json
data = json.load(sys.stdin)
print(f'Found {data[\"total\"]} skills:')
for s in data['items']:
    desc = s.get('description') or ''
    print(f'  {s[\"full_name\"]}  ★{s[\"stars\"]}  {desc[:80]}')
"

AgentSkill.work API 参考

Endpoint	说明
GET /api/skills	列出/搜索技能
GET /api/skills/{owner}/{repo}	技能详情
GET /api/skills/{owner}/{repo}/related	相关技能
GET /api/facets/topics?limit=20	可用主题
GET /api/facets/languages?limit=20	可用语言

/api/skills 的查询参数：

参数	类型	默认值	说明
q	string	—	关键词搜索
topic	string	—	按 GitHub 主题筛选
language	string	—	按编程语言筛选
owner	string	—	按 GitHub 所有者筛选
sort	stars | newest	stars	排序方式
limit	1-100	20	每页结果数
offset	int	0	分页偏移量

2. 呈现结果

将两个来源的结果合并为一个列表。每个技能显示：

• 名称——slug（ClawHub）或 owner/repo（AgentSkill.work）
• 描述——一行说明
• 星标 / 下载量——如有
• 来源——ClawHub / AgentSkill.work / 两者
• 安装命令

使用编号列表或紧凑表格。如果用户使用中文，请优先采用 AgentSkill.work 中的 description_zh 或 summary_zh。

3. 安装前检查

在确定安装前获取技能详情：

# ClawHub — metadata, stats, owner
npx clawhub inspect <slug> --json

# ClawHub — see what files are included
npx clawhub inspect <slug> --files

# ClawHub — read a specific file
npx clawhub inspect <slug> --file SKILL.md

# AgentSkill.work — full detail with features, use cases
curl -s "https://agentskill.work/api/skills/<owner>/<repo>"

4. 安装

从 ClawHub 安装（优先——带版本且经过验证）：

npx clawhub install <slug>

添加 --force 可覆盖现有安装。

从 GitHub 安装（仅当技能只在 AgentSkill.work 上时）：

cd skills/
git clone <html_url> <skill-name>

克隆后，确认 SKILL.md 存在。如果缺失，该仓库可能不是正规的 Agent 技能。

5. 验证

openclaw skills list 2>&1 | grep -i "<skill-name>"
openclaw skills check  # shows ready vs missing requirements

新技能会在下一个会话中加载，无需重启。

浏览与探索

# ClawHub trending / most downloaded
npx clawhub explore --sort trending --limit 10
npx clawhub explore --sort downloads --limit 10

# AgentSkill.work — discover topics
curl -s "https://agentskill.work/api/facets/topics?limit=20"

# AgentSkill.work — browse a topic
curl -s "https://agentskill.work/api/skills?topic=mcp&sort=stars&limit=10"

提示

• ClawHub 搜索具有语义理解能力——搜索“向我的手机发送通知”，即使技能名称中没有这些词，也能找到推送通知技能。
• AgentSkill.work 提供双语元数据——description_zh、summary_zh、key_features_zh 可用于中文描述。
• 许多技能同时存在于两个来源——如果某个技能在 ClawHub 和 AgentSkill.work 上都有，优先从 ClawHub 安装（带版本，打包更规范）。
• 相关技能——找到一个技能后，检查 /api/skills/{owner}/{repo}/related 以发现类似技能。
• 未找到技能？ 直接帮助用户，然后建议使用 npx clawhub publish 或 skill-creator 技能创建技能。