Skill API: endpoint list-Alibaba Cloud Model Studio(Model Studio)-阿里云帮助中心

A skill packages a set of tools and documentation as a zip archive. After upload, it must pass a security scan before it can be attached to an agent. Attachment locks to a specific version number.

Scan status

After creating a skill or uploading a new version, the artifact enters a security scan. status transitions as follows:

Status	Meaning
`checking`	Scan in progress; cannot be attached yet.
`active`	Scan passed; can be attached to an agent.
`rejected`	Hit a security risk and cannot be attached; the version detail provides per-file issues under `additional_properties.error_info`.
`deleted`	Skill has been deleted.

Attachment happens on the agent — see the skills field on Agent. The attachment must specify a concrete version (latest is not supported); uploading new versions later does not affect already-attached agents.

Skill operations

Operation	Endpoint	Description
Create a skill	`POST /skills`	Create a skill from a previously uploaded zip `file_id`.
Retrieve Skill	`GET /skills/{skill_id}`	Get skill metadata and the latest version number.
List Skills	`GET /skills`	Paginated list of skills; can be filtered by `source` (customer / official).
Delete Skill	`DELETE /skills/{skill_id}`	Delete the skill and all its versions; agents that already attached an older version are unaffected.

Version operations

Operation	Endpoint	Description
Upload New Skill Version	`POST /skills/{skill_id}/versions`	Upload a new version from a new zip `file_id`; agents that already attached an older version are unaffected.
List Skill Versions	`GET /skills/{skill_id}/versions`	Paginated list of all versions of the skill, ordered by version number descending.
Retrieve Skill Version	`GET /skills/{skill_id}/versions/{version}`	Query the metadata and scan status of a specific version.
Download Skill Package	`GET /skills/{skill_id}/versions/{version}/content`	Returns an OSS pre-signed URL (valid for 2 hours) for downloading the zip package.