GetSkill-阿里云帮助中心

Retrieves the details of a specified Skill by name, including the body of the SKILL.md file and the bundle's download link.

Operation description

Overview

request parameters: The name of the target Skill.
response parameters: The details of the Skill, including its name, description, creator ID, modifier ID, visibility level, visibility scope, the body of the SKILL.md file, a temporary download link for bundle.zip (which requires no authentication and will expire), the creation time, and the last modified time.
Note: The BundleUrl is a temporary download link. Once the link expires, you must call this operation again to get a new one.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter	Type	Required	Description	Example
Name	string	Yes	The unique name of the Skill.	my-skill

Response elements

Element	Type	Description	Example
	object	The response data.
RequestId	string	The unique ID for the request.	824F80BA-1778-5D8A-BAFF-668A4D9C4CC7
Skill	object	The returned Skill object.
CreatorId	string	The ID of the user who created the Skill.	123456
ModifierId	string	The ID of the user who last modified the Skill.	123456
Name	string	The name of the Skill.	my-skill
Description	string	The Skill description.	数据分析技能
Visibility	string	The visibility level.	TENANT
Body	string	The content of the SKILL.md file.	把大象装冰箱需要3步，把冰箱门打开，把大象放进去，把冰箱门关上。
VisibilityScope	object	The visibility scope.
ProjectIds	array	A list of project IDs that can access the Skill.
	string	A project ID.	123456
UserIds	array	A list of user IDs that can access the Skill.
	string	A user ID.	123456
GmtCreateTime	string	The time the Skill was created, provided as a UNIX timestamp in milliseconds.	1780555634000
GmtModifiedTime	string	The time the Skill was last modified, provided as a UNIX timestamp in milliseconds.	1780555634000
BundleUrl	string	A temporary download link for `bundle.zip`, which does not require authentication and will expire.	https://your-bucket.oss-cn-hangzhou.aliyuncs.com/xxx.zip?Expires=...&Signature=...

Examples

Success response

JSON format

{
  "RequestId": "824F80BA-1778-5D8A-BAFF-668A4D9C4CC7",
  "Skill": {
    "CreatorId": "123456",
    "ModifierId": "123456",
    "Name": "my-skill",
    "Description": "数据分析技能",
    "Visibility": "TENANT",
    "Body": "把大象装冰箱需要3步，把冰箱门打开，把大象放进去，把冰箱门关上。",
    "VisibilityScope": {
      "ProjectIds": [
        "123456"
      ],
      "UserIds": [
        "123456"
      ]
    },
    "GmtCreateTime": "1780555634000",
    "GmtModifiedTime": "1780555634000",
    "BundleUrl": "https://your-bucket.oss-cn-hangzhou.aliyuncs.com/xxx.zip?Expires=...&Signature=..."
  }
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.