# Skills Pool

> Agent Skill Search Engine — browse, search, and discover AI agent skills.

Skills Pool indexes and organizes agent skill files (SKILL.md) from open-source repositories, making them easy to discover, search, and install.

## Search API

```
GET https://skillspool.org/api/v1/skills/search?q={keywords}&limit={n}
```

Returns JSON array of matching skills with: name, description, author, stars, categories, occupation, slug.
Use English keywords for best results. Default limit is 20, max 100.

### Example

```
GET https://skillspool.org/api/v1/skills/search?q=code+review&limit=5
```

## Other API Endpoints

- `GET /api/v1/categories` — list all skill categories
- `GET /api/v1/occupations` — list all occupations
- `GET /api/v1/skills/{slug}` — get skill detail by slug
- `GET /api/v1/stats` — site statistics (total skills, authors, categories)

## Install a Skill

```
npx skills add {owner}/{repo}
```

Or with other package managers:
- `bunx skills add {owner}/{repo}`
- `pnpm dlx skills add {owner}/{repo}`

The {owner}/{repo} is the GitHub repository that contains the skill (e.g. `openclaw/openclaw`).

## Find-Skill Agent Skill

Install this skill to let your AI agent search the Skills Pool directory:

```
npx skills add mechanicianwang/skillspool-find-skill
```

Or clone: `git clone https://github.com/mechanicianwang/skillspool-find-skill.git`

## Recommended Workflow

1. Extract keywords from the user's request
2. Call the Search API
3. Sort results by relevance and stars
4. Recommend up to 5 skills
5. Help install the selected skill

## Rules

- Do NOT scrape the website — use the API
- Do NOT bypass rate limits
- Do NOT auto-install skills without user confirmation
- Do NOT use API data for model training

## Security Check

- High stars (>1000) = trusted
- Well-known author = trusted
- Zero stars + unknown author = warn the user

## Links

- Website: https://skillspool.org
- Sitemap: https://skillspool.org/api/sitemaps/index.xml
- GitHub: https://github.com/mechanicianwang/skillkit