🔍 skill-finder

An OpenClaw skill that helps your AI agent discover and install agent skills from multiple registries.

"Find me a skill for managing GitHub PRs" → searches ClawHub + AgentSkill.work → presents options → installs with one command.

Why?

The agent skill ecosystem is growing fast but fragmented. Skills live on ClawHub, AgentSkill.work, and scattered across GitHub. This skill teaches your agent to search them all from a single conversation.

Features

• Dual-source search — ClawHub (semantic vector search) + AgentSkill.work (330+ GitHub repos with enriched metadata)
• Smart install — ClawHub packages install via clawhub install, GitHub-only repos via git clone
• Browse & explore — trending, most downloaded, by topic, by language
• Bilingual — AgentSkill.work provides Chinese descriptions for CJK users
• Inspect before install — preview skill contents, stats, and owner info
• Zero config — no API keys, no setup, works out of the box

Install

Via ClawHub (recommended)

npx clawhub install skill-finder

Via Git

cd your-workspace/skills/
git clone https://github.com/yfge/skill-finder.git

Manual

Copy SKILL.md into your workspace's skills/skill-finder/ directory.

Usage

Once installed, your agent automatically activates this skill when you ask things like:

• "Find me a skill for PDF editing"
• "Is there a skill that can manage my calendar?"
• "Search for MCP-related skills"
• "What skills are trending right now?"
• "Install the weather skill"

The agent will search both registries, present results, and offer to install your pick.

Data Sources

Source	Type	Skills	Search	URL
ClawHub	Official registry	Curated & versioned	Semantic (vector)	clawhub.com
AgentSkill.work	GitHub directory	330+ repos	Keyword + filters	agentskill.work

AgentSkill.work API

The skill uses the public AgentSkill.work REST API:

GET /api/skills?q={query}&topic={topic}&language={lang}&sort=stars&limit=10
GET /api/skills/{owner}/{repo}
GET /api/skills/{owner}/{repo}/related
GET /api/facets/topics
GET /api/facets/languages

No authentication required. Full API documentation at agentskill.work.

How It Works

User: "Find a skill for managing GitHub issues"
  │
  ├─→ ClawHub semantic search: "github issues"
  │     └─→ gh-issues v1.0.0 (score: 3.8)
  │     └─→ github v1.0.0 (score: 3.2)
  │
  ├─→ AgentSkill.work API: /api/skills?q=github+issues&sort=stars
  │     └─→ anthropics/skills ★75k
  │     └─→ some-user/gh-skill ★200
  │
  └─→ Merged results → Present to user → Install on confirmation

Requirements

• OpenClaw (any version)
• npx (comes with Node.js) — for ClawHub CLI
• curl + python3 — for AgentSkill.work API (available on macOS/Linux by default)
• Internet access

Contributing

Contributions welcome! Some ideas:

• Add more skill registries / directories
• Improve search result ranking across sources
• Add skill compatibility checking
• Create a skill recommendation engine

See CONTRIBUTING.md for guidelines.

License

MIT © yfge