# SkillKit  
```  
1.12.0  
```  
``` OAS 3.1 ```

Skills shouldn't require pre-installation. This API lets any agent, framework, or tool discover and retrieve skills on demand.

400K+ skills across 46 AI coding agents. Results ranked by a multi-signal scoring system (content 40pts, query match 30pts, popularity 15pts, references 15pts).

## Quick Start

```
npx skillkit serve
```

The API is now running at http://localhost:3737

## MCP Server

For agent-native discovery (Claude Desktop, Cursor):

```
{
  "mcpServers": {
    "skillkit": { "command": "npx", "args": ["@skillkit/mcp"] }
  }
}
```

## Python Client

```
pip install skillkit-client
```

Servers

http://localhost:3737 - Local development (skillkit serve)

### [Search](/content/api#/Search/index.html)    Skill search and filtering

GET  
[/search](/content/api#/Search/searchSkillsGet/index.html)

Search skills

POST  
[/search](/content/api#/Search/searchSkillsPost/index.html)

Search skills with filters

### [Skills](/content/api#/Skills/index.html)    Individual skill retrieval

GET  
[/skills/{owner}/{repo}/{id}](/content/api#/Skills/getSkill/index.html)

Get skill by ID

### [Discovery](/content/api#/Discovery/index.html)    Trending skills and categories

GET  
[/trending](/content/api#/Discovery/getTrending/index.html)

Trending skills

GET  
[/categories](/content/api#/Discovery/getCategories/index.html)

Skill categories

Browse all skill categories with counts. See what's available before searching.

#### Parameters

Cancel

No parameters

Execute

#### Responses

| Code | Description | Links |
| --- | --- | --- |
| 200 | Category list with counts<br>Media type<br>application/json<br>Controls `Accept` header.<br>- Example Value<br>- Schema<br>```json<br>{<br>  "categories": [<br>    {<br>      "name": "react",<br>      "count": 156<br>    },<br>    {<br>      "name": "typescript",<br>      "count": 134<br>    },<br>    {<br>      "name": "testing",<br>      "count": 89<br>    }<br>  ],<br>  "total": 89<br>}<br>``` | _No links_ |

### [System](/content/api#/System/index.html)    Health checks and diagnostics

GET  
[/health](/content/api#/System/getHealth/index.html)

Health check

GET  
[/cache/stats](/content/api#/System/getCacheStats/index.html)

Cache statistics

#### Schemas

**Skill**  
Collapse all **object**

- name

- description

- source

- repo

- tags

- category

- content

- stars

- installs

**SearchResponse**  
Collapse all **object**

- skills

- total

- query

- limit

**TrendingResponse**  
Collapse all **object**

- skills

- limit

**CategoriesResponse**  
Collapse all **object**

- categories

- total

**CategoryCount**  
Collapse all **object**

- name

- count

**HealthResponse**  
Collapse all **object**

- status

- version

- skillCount

- uptime

**CacheStatsResponse**  
Collapse all **object**

- hits

- misses

- size

- maxSize

- hitRate

**ErrorResponse**  
Collapse all **object**

- error

**RateLimitResponse**  
Collapse all **object**

- error

- retryAfter