Skip to content
EN

Back to the catalog

skill-finder

yfge/skill-finder · skills.sh

Open source Repository Open in the app JSON README (API)

About

Skill publicada por yfge/skill-finder no skills.sh. Instale com: npx skills add yfge/skill-finder@skill-finder

Details

Kind
Agent skills
Publisher
yfge
Origin
skillssh
Category
ferramentas
Stars
3
Forks
1
Last push
2026-02-25T15:45:53Z
Repository state
ativo
License
MIT
Added
2026-10-07 06:29:46
Updated
2026-10-07 06:29:46
Origin id
yfge/skill-finder/skill-finder

README

# 🔍 skill-finder

An [OpenClaw](https://github.com/openclaw/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](https://clawhub.com), [AgentSkill.work](https://agentskill.work), and scattered across GitHub. This skill teaches your agent to search them all from a single conversation.

## Features

- **Dual-source search** — [ClawHub](https://clawhub.com) (semantic vector search) + [AgentSkill.work](https://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)

```bash
npx clawhub install skill-finder
```

### Via Git

```bash
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](https://clawhub.com) |
| **AgentSkill.work** | GitHub directory | 330+ repos | Keyword + filters | [agentskill.work](https://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](https://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](https://github.com/openclaw/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](https://github.com/yfge/skill-finder/blob/HEAD/CONTRIBUTING.md) for guidelines.

## License

[MIT](https://github.com/yfge/skill-finder/blob/HEAD/LICENSE) © [yfge](https://github.com/yfge)

More