Cloud Skills Portal:Get started with Alibaba Cloud Skills

Step 1: Browse the Skills Portal and select a Skill

1. Go to the Skills Portal.

2. Enter a keyword in the search box at the top of the page, such as "resource search", or browse by product category.

3. Click the target Skill to open its detail page. The detail page displays the Skill capabilities, installation command, and example prompts. The following steps use Resource Center global resource search (alibabacloud-resourcecenter-search) as an example.

Step 2: Install the Skill

On the Skill detail page, click Install Guide at the top. Select your installation options, copy the generated command, and run it in your terminal.

npx skills add aliyun/alibabacloud-aiops-skills --skill <skill-name> --agent <client> -y --full-depth

npx clawhub install <skill-name>

npx skills ls

npx skills ls -g

Step 3: Use the Skill in your Agent client

After installation, restart the Agent client to load the Skill. The following examples use Claude Code, Cursor, and Qoder:

# ECS Instance Search Results
Found **3** ECS instances.

| Instance ID | Instance Name | Region | Status | Instance Type |
|---------|---------|------|------|------|
| i-bp1abc**** | web-server-01 | cn-hangzhou | Running | ecs.g6.large |
| i-bp2def**** | db-server-01 | cn-hangzhou | Running | ecs.r6.xlarge |
| i-bp3ghi**** | test-instance | cn-shanghai | Stopped | ecs.c6.large |

Step 4: Try more operations

After confirming that the Skill works, try more complex tasks. The Resource Center global resource search Skill supports prompts such as:

Show me all cloud resources in the China East 1 (Hangzhou) region.

Show me the resource count for each product type under my current account.

Why can't my Agent client find the installed Skill?

This issue is typically caused by a directory mismatch, a stale client session, or incomplete Skill files. Troubleshoot as follows:

• Verify that you ran the installation command in the correct project directory. Skills are installed to the project-level directory .<client>/skills/ by default and will not automatically take effect in other projects. To use a Skill across projects, add the -g flag for global installation.

• After installation, restart the Agent client or reopen the current project in the client to let it rescan the skills directory.

• Run ls .<client>/skills/<skill-name>/ to verify that the SKILL.md file exists. If the file is missing or the directory is empty, delete the directory and run the installation command again.

• When a Skill with the same name is installed in both project and global scope, the project directory takes priority. If a global update does not take effect, check whether an older version remains in the project directory.

Why does the npx skills add command fail?

Installation failures typically stem from the Node.js environment, network connectivity, or directory permissions. Troubleshoot as follows:

• If you see command not found: npx, run node --version to verify that Node.js is installed and the version is 18 or later. If Node.js is not installed, refer to Node.js official website for installation.

• If the error is a network timeout or slow download, check your local network connection and try again.

• If the error is a permission error (such as EACCES or permission denied), do not use sudo to run npx. Instead, check and fix the write permissions of the current user for the project directory.

• If the error is 404 Not Found or the Skill name does not exist, go to the Skills Portal and verify that the Skill identifier is spelled correctly and the Skill has been published.

Why do I get errors when the Agent invokes a Skill?

Invocation errors typically stem from CLI credential issues, insufficient RAM permissions, or an inactive Resource Center service. Troubleshoot as follows:

• If the error is an authentication failure, run aliyun sts get-caller-identity to verify that the current CLI credentials are valid and have not expired. If they have expired, run aliyun configure to reconfigure.

• If the error is insufficient permissions (such as Forbidden.RAM or NoPermission), go to the RAM console and add the required permission policy for the current RAM user or role. Resource Center search requires the AliyunResourceCenterReadOnlyAccess permission. Then let the Agent retry.

• If the error indicates that Resource Center is not activated (such as ServiceNotEnabled), run aliyun resourcecenter enable-resource-center to activate the service and try again.

• If the error involves a specific cloud product API (such as ECS or SAS), refer to the corresponding cloud product documentation to add the required permissions for the RAM user.