1. Search Skills — Find Alibaba Cloud Agent Skills by keyword, category, or both
2. Browse Categories — Explore available skill categories and subcategories
3. View Skill Details — Get detailed information about specific skills
4. Install Skills — Guide users through skill installation process

• "Find a skill for managing ECS instances"
• "What Alibaba Cloud skills are available for databases?"
• "阿里云有哪些 OSS 相关的 skill?"
• "Browse all available alicloud skills"
• "Install a skill for RDS management"

Pre-check: Aliyun CLI >= 3.3.1 required

Run

aliyun version

to verify >= 3.3.1. If not installed or version too low, see references/cli-installation-guide.md for installation instructions. Then [MUST] run

aliyun configure set --auto-plugin-install true

to enable automatic plugin installation.

Pre-check: Alibaba Cloud Credentials Required

Security Rules:

• NEVER read, echo, or print AK/SK values (e.g.,

  echo $ALIBABA_CLOUD_ACCESS_KEY_ID

  is FORBIDDEN)
• NEVER ask the user to input AK/SK directly in the conversation or command line
• NEVER use

  aliyun configure set

  with literal credential values
• ONLY use

  aliyun configure list

  to check credential status

bash

aliyun configure list --user-agent AlibabaCloud-Agent-Skills

Check the output for a valid profile (AK, STS, or OAuth identity).

If no valid profile exists, STOP here.

1. Obtain credentials from Alibaba Cloud Console
2. Configure credentials outside of this session (via

   aliyun configure

   in terminal or environment variables in shell profile)
3. Return and re-run after

   aliyun configure list

   shows a valid profile

agentexplorer:ListCategories

agentexplorer:SearchSkills

agentexplorer:GetSkillContent

[MUST] Permission Failure Handling: When any command or API call fails due to permission errors at any point during execution, follow this process:

1. Read

   references/ram-policies.md

   to get the full list of permissions required by this SKILL
2. Use

   ram-permission-diagnose

   skill to guide the user through requesting the necessary permissions
3. Pause and wait until the user confirms that the required permissions have been granted

IMPORTANT: Parameter Confirmation — Before executing any command or API call, ALL user-customizable parameters (e.g., keyword, category-code, skill-name, max-results, etc.) MUST be confirmed with the user. Do NOT assume or use default values without explicit user approval.

keyword

category-code

max-results

next-token

skip

skill-name

1. List Categories: Response contains categoryCode and categoryName fields
2. Search Skills: Response contains skills array with valid skill objects
3. Get Skill Content: Response contains complete skill markdown content
4. Install Skill: Skill appears in Claude Code skills list

• Use product codes:

  ecs

  ,

  rds

  ,

  oss

  ,

  slb

  ,

  vpc

  (English abbreviations work best)
• Chinese names: Also supported, e.g., "云服务器", "数据库", "对象存储"
• Feature terms: "backup", "monitoring", "batch operation", "deployment"
• Generic terms: When unsure, use broader terms like "compute", "storage", "network"

• Browse first: Use

  list-categories

  to understand available categories
• Top-level categories:

  computing

  ,

  database

  ,

  storage

  ,

  networking

  ,

  security

  , etc.
• Subcategories: Use dot notation like

  computing.ecs

  ,

  database.rds

• Multiple categories: Separate with commas:

  computing,database

• Start broad: Begin with keyword-only search, then add category filters
• Adjust page size: Use

  --max-results

  based on display needs (20-50 typical)
• Check install counts: Popular skills usually have higher install counts
• Read descriptions: Match skill description to your specific use case

Found N skills:

| Skill Name | Display Name | Description | Category | Install Count |
|------------|--------------|-------------|----------|---------------|
| alibabacloud-ecs-batch | ECS Batch Operations | Batch manage ECS instances | Computing > ECS | 245 |
| ... | ... | ... | ... | ... |

• skillName: For installation and detailed queries
• displayName: User-friendly name
• description: Brief overview
• categoryName + subCategoryName: Classification
• installCount: Popularity indicator

1. Always verify credentials first — Use

   aliyun configure list

   before any search operation
2. Confirm parameters with user — Never assume keyword or category without asking
3. Start with broad searches — Narrow down with filters if too many results
4. Show category structure — Help users understand available categories before filtering
5. Display results clearly — Use tables to make skill comparison easy
6. Provide skill names — Always show

   skillName

   field for installation
7. Handle pagination — Offer to load more results if

   nextToken

   is present
8. Check install counts — Guide users toward popular, well-tested skills
9. Show full details — Use

   get-skill-content

   before installation recommendation
10. Test after install — Verify skill is available after installation

1. Try broader keywords
2. Remove category filter
3. Use

   list-categories

   to verify category codes
4. Try English product codes instead of Chinese names

• Read-only operations: This skill only performs queries, no resources are created
• No credentials required for browsing: Some operations may work without full credentials
• Multi-language support: Keywords support both English and Chinese
• Regular updates: Skills catalog is regularly updated with new skills
• Community skills: Some skills may be community-contributed, check descriptions carefully