Retrieve Skill

Prerequisites

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

Endpoint

GET /skills/{skill_id}

Request example

curl "$AGENTSTUDIO_URL/skills/skill_xxx" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

Response example

{
  "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:03Z",
  "updated_at": "2026-06-16T08:12:47Z",
  "request_id": "xxx"
}

Response 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
`request_id`	string	Unique identifier for this request

​Prerequisites

​Endpoint

​Request example

​Response example

​Response fields

Prerequisites

Endpoint

Request example

Response example

Response fields