List Skills

GET

/skills

GET

/api/v1/skills

$ curl https://app.rightbrain.ai/api/v1/skills \
>      -H "Authorization: Bearer <token>"

1 {
2   "results": [
3     {
4       "id": "string",
5       "slug": "string",
6       "display_name": "string",
7       "description": "string",
8       "license": "string",
9       "compatibility": "string",
10       "source": {
11         "id": "string",
12         "name": "string",
13         "description": "string",
14         "url": "string"
15       },
16       "tags": [
17         "string"
18       ],
19       "has_active_revision": true,
20       "has_capabilities": true,
21       "requires_prerequisites": true,
22       "active_revision": {
23         "id": "string",
24         "annotation": "string",
25         "created": "string"
26       },
27       "created": "string",
28       "modified": "string"
29     }
30   ],
31   "pagination": {
32     "next_cursor": "019097c5-5560-05b5-4a48-5197a269683b",
33     "has_next": true,
34     "page_limit": 100
35   }
36 }

Browse the global skill catalog using lightweight metadata only. Supports filtering by source, tag name, and free-text search.

Authentication

AuthorizationBearer

Bearer token authentication using JWT tokens from Ory Kratos/Hydra

Query parameters

page_limitintegerOptional1-100Defaults to 100

The maximum number of items to return per page. Defaults to 100 if not specified.

cursorstringOptionalformat: "uuid"

A cursor for pagination. Use the next_cursor value from the previous response to get the next page of results.

sourcestringOptional

Filter skills by source name.

searchstringOptional

Search skill slug, display name, and description.

taglist of stringsOptional

Repeat to filter by one or more skill tags.

tagslist of stringsOptional

Repeat to filter by one or more skill tags.

Response

Successfully retrieved skills

resultslist of objects

The list of items returned for the current page.

paginationobject or null

Contains pagination information for the result set.

Errors

401

Unauthorized Error

422

Unprocessable Entity Error

500

Internal Server Error