REST API
A versioned, read-only JSON API. No key is needed. Requests are rate limited (120 per minute by default) and report the limit in
X-RateLimit-* headers. Errors use one shape: {"error":{"code":"…","message":"…"}}. Rows marked Planned do not exist yet.| Method | Path | Purpose | Status |
|---|---|---|---|
| GET | /api/health | Liveness and database check. | Available |
| GET | /api/v1/skills | List skills: q, agent, verification, category, sort, page, per_page. | Available |
| GET | /api/v1/skills/:id | One skill with files, compatibility and ranking signals. | Available |
| GET | /api/v1/skills/:id/versions | Indexed versions of a skill. | Available |
| GET | /api/v1/skills/:id/security | Security report for the current version. | Available |
| GET | /api/v1/skills/:id/install | Install, update and uninstall instructions. Query: agent, scope (project|global), method (symlink|copy|manual), pin (true|false), shell (posix|powershell). | Available |
| GET | /api/v1/search | Ranked search; q is required. | Available |
| GET | /api/v1/suggest | Skill-name completions for a partial query. | Available |
| GET | /api/v1/categories | Categories with counts. | Available |
| GET | /api/v1/trending | Trending skills, with the basis used. | Available |
| GET | /api/v1/repositories/:id | One repository. | Available |
| POST | /api/v1/submissions | Suggest a GitHub repository (JSON body). | Available |
| POST | /api/v1/reports | Report a problem with a skill or finding (JSON body). | Available |
| GET | /api/v1/openapi.json | OpenAPI 3.1 description of this API. | Available |