Skip to content

For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.

List all skills for the current project.

$ openai skills list

GET/skills

List all skills for the current project.

ParametersExpand Collapse

--after: optional string

Identifier for the last item from the previous pagination request

--limit: optional number

Number of items to retrieve

--order: optional "asc" or "desc"

Sort order of results by timestamp. Use asc for ascending order or desc for descending order.

ReturnsExpand Collapse

skill_list: object { data, first_id, has_more, 2 more }

data: array of Skill { id, created_at, default_version, 4 more }

A list of items

View schema details

first_id: string

The ID of the first item in the list.

has_more: boolean

Whether there are more items available.

last_id: string

The ID of the last item in the list.

object: "list"

The type of object returned, must be list.

List all skills for the current project.

openai skills list \
  --api-key 'My API Key'

{
  "data": [
    {
      "id": "id",
      "created_at": 0,
      "default_version": "default_version",
      "description": "description",
      "latest_version": "latest_version",
      "name": "name",
      "object": "skill"
    }
  ],
  "first_id": "first_id",
  "has_more": true,
  "last_id": "last_id",
  "object": "list"
}

Returns Examples

{
  "data": [
    {
      "id": "id",
      "created_at": 0,
      "default_version": "default_version",
      "description": "description",
      "latest_version": "latest_version",
      "name": "name",
      "object": "skill"
    }
  ],
  "first_id": "first_id",
  "has_more": true,
  "last_id": "last_id",
  "object": "list"
}