---
title: "List skills"
method: GET
path: "/v1alpha/skills"
tags: ["Skills"]
---

# List skills

`GET /v1alpha/skills`

List all skills.

## Query parameters

- `after` string, nullable — Cursor for pagination
- `limit` integer — Maximum number of results
- `order` 'asc' | 'desc' — Sort order by created_at

## Response `200`

Successful Response

- ListSkillsResponse — Response from listing skills.
  - `object` 'list'
  - `data` Skill[], required — List of skill objects
    - `id` string, required — Unique identifier for the skill
    - `created_at` integer, required — Unix timestamp when the skill was created
    - `default_version` string — Version used when no version is specified
    - `description` string, required — Description of what the skill does
    - `latest_version` string — Most recently uploaded version number
    - `name` string, required — Human-readable name from SKILL.md frontmatter
    - `object` 'skill'
  - `has_more` boolean — Whether there are more results
  - `first_id` string, nullable — ID of the first item in the list
  - `last_id` string, nullable — ID of the last item in the list

## Other responses

- `400` — The request was invalid or malformed
- `429` — The client has sent too many requests in a given amount of time
- `500` — The server encountered an unexpected error
- `default` — An error occurred

---

[API](https://skmtc.net/ogx-ai/apis/ogx-specification-stable-experimental-apis.md) · [All operations](https://skmtc.net/ogx-ai/apis/ogx-specification-stable-experimental-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ogx-ai/ogx-specification-stable-experimental-apis/versions/f3f783962256/schema)