Skip to main content
GET
/
api
/
skills
Error
A valid request URL is required to generate request examples
{
  "skills": [
    {
      "id": "<string>",
      "name": "review-migrations",
      "description": "Reviews database migration safety and rollback behavior.",
      "license": "MIT",
      "compatibility": "Claude Code, Codex",
      "metadata": {},
      "extra_frontmatter": {},
      "allowed_tools": "<string>",
      "skill_md_body": "<string>",
      "latest_version": "1.0.0",
      "created_by": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "files": [
        {
          "path": "references/style-guide.md",
          "mime_type": "text/markdown",
          "content": "<string>",
          "source_url": "<string>",
          "dataurl": "data:text/plain;base64,SGVsbG8=",
          "upload_id": "<string>",
          "storage_key": "<string>",
          "blob_id": "<string>",
          "id": "<string>",
          "skill_version_id": "<string>",
          "file_size_bytes": 123,
          "created_at": "2023-11-07T05:31:56Z",
          "updated_at": "2023-11-07T05:31:56Z"
        }
      ],
      "file_count": 123,
      "highest_version": "1.2.0"
    }
  ],
  "total": 123,
  "limit": 123,
  "offset": 123
}

Authorizations

Authorization
string
header
required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <API key>. Virtual keys, dashboard/user/session tokens, and x-api-key headers are not supported on management APIs.

Query Parameters

Search by skill name or description.

sort_by
enum<string>
default:created_at

Field to sort by.

Available options:
name,
updated_at,
created_at
order
enum<string>
default:desc

Sort order.

Available options:
asc,
desc
limit
integer
default:50

Number of skills to return. Maximum 100.

Required range: 1 <= x <= 100
offset
integer
default:0

Number of skills to skip.

Required range: x >= 0

Response

Successful response

skills
object[]
total
integer<int64>
limit
integer
offset
integer