List Skills

Prerequisites

Endpoint and authentication configured. For details, see Overview and authentication.

Endpoint

GET /skills

Query parameters

Parameter	Required	Type	Default	Description
`limit`	No	int	20	Number of items per page, maximum 100
`page`	No	string	—	Omit on the first call; pass `next_page` from the previous response for subsequent calls
`source`	No	string	`customer`	Source filter: `customer` (self-built) or `official` (Model Studio official)

Request example

curl "$AGENTSTUDIO_URL/skills?source=customer&limit=20" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

Response example

{
  "data": [
    {
      "id": "skill_xxx",
      "type": "skill",
      "name": "pdf3.0",
      "description": "Use this skill whenever the user wants to do anything with PDF files...",
      "source": "customer",
      "status": "active",
      "latest_version": "1.1",
      "created_at": "2026-06-16T07:56:03+00:00",
      "updated_at": "2026-06-16T08:12:47+00:00"
    }
  ],
  "next_page": "skill_xxx",
  "request_id": "xxx"
}

The response contains data (an array of Skill objects) and next_page. Skill object fields are as follows:

Skill object fields

Field	Type	Description
`id`	string	Skill ID, format: `skill_xxx`
`type`	string	Fixed value `skill`
`name` / `description`	string	Parsed from `SKILL.md` inside the zip
`source`	string	Source: `customer` (self-built) / `official` (Model Studio official)
`status`	string	Scan status: `checking` / `active` / `rejected` / `deleted`. Only `active` can be mounted
`latest_version`	string	Latest version number. When mounting to an agent, do not lock to `latest`; you must specify a concrete version
`created_at` / `updated_at`	string	Creation / last update time, ISO 8601

​Prerequisites

​Endpoint

​Query parameters

​Request example

​Response example