Skip to content
skillxone

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.
API endpoints and their status
MethodPathPurposeStatus
GET/api/healthLiveness and database check.Available
GET/api/v1/skillsList skills: q, agent, verification, category, sort, page, per_page.Available
GET/api/v1/skills/:idOne skill with files, compatibility and ranking signals.Available
GET/api/v1/skills/:id/versionsIndexed versions of a skill.Available
GET/api/v1/skills/:id/securitySecurity report for the current version.Available
GET/api/v1/skills/:id/installInstall, update and uninstall instructions. Query: agent, scope (project|global), method (symlink|copy|manual), pin (true|false), shell (posix|powershell).Available
GET/api/v1/searchRanked search; q is required.Available
GET/api/v1/suggestSkill-name completions for a partial query.Available
GET/api/v1/categoriesCategories with counts.Available
GET/api/v1/trendingTrending skills, with the basis used.Available
GET/api/v1/repositories/:idOne repository.Available
POST/api/v1/submissionsSuggest a GitHub repository (JSON body).Available
POST/api/v1/reportsReport a problem with a skill or finding (JSON body).Available
GET/api/v1/openapi.jsonOpenAPI 3.1 description of this API.Available