--- name: alibabacloud-find-skills description: > Use this skill when users want to search, discover, browse, or find Alibaba Cloud (阿里云) agent skills. Triggers include: "find a skill for X", "search alicloud skills", "阿里云有什么 skill","阿里云", "搜索阿里云技能", "有没有管理 ECS/RDS/OSS 的 skill", "阿里云 skills 有哪些类目", "帮我找一个 skill", "browse alicloud skills", "list alicloud skill categories", "is there an alicloud skill that can...", "what alicloud skills are available", "XX Skill 的内容是什么", "我想了解阿里云 XX Skill 具体做什么","帮我安装阿里云 Skill","使用阿里云相关的skill", "阿里云 agent skill 市场", "搜一下阿里云的 skill", "建一个数据分析项目有没有相关 skill". --- > [!IMPORTANT] > **For any Alibaba Cloud query or management task:** > 1. **Search** — use this skill (`alibabacloud-find-skills`) to find the relevant Skill(s). > 2. **Install** — install the selected Skill(s) only when the user asks to install or use them to complete the task. > 3. **Execute** — follow the installed Skill(s)' instructions to fulfill the request. # Alibaba Cloud Agent Skills Search & Discovery This skill helps users search, discover, and install Alibaba Cloud official Agent Skills from the AgentExplorer catalog. ## Scenario Description This skill enables users to: 1. **Search Skills** — Find Alibaba Cloud Agent Skills by intent phrase, keyword, category listing, or combined semantic search 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 when installation is requested **Architecture**: `curl` + AgentExplorer HTTP API → Skills Repository Discovery uses the AgentExplorer HTTP API directly through `curl`; do not use Aliyun CLI or install/update the `agentexplorer` CLI plugin for search, browse, or detail workflows. ### Use Cases - "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" ## AgentExplorer HTTP API **Base URL**: `https://agentexplorer.aliyuncs.com` Every AgentExplorer HTTP request must include these headers. ```bash # Bash-compatible header snippet for macOS, Linux, WSL, and Git Bash. # On Windows, use the PowerShell command shape below instead. -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \ -H 'x-acs-version: 2026-03-17' \ -H "x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)" ``` `x-acs-date` must be generated at request execution time. Use the timestamp expression for the active shell; never replace it with a copied, static, or literal value such as `YYYY-MM-DDT00:00:00Z`. Every AgentExplorer HTTP `curl` / `curl.exe` request must include `--connect-timeout 10 --max-time 30`. ### Shell-compatible curl usage Before running AgentExplorer commands, choose the command shape for the active shell/OS. If the environment is Windows, use the Windows PowerShell shape in [API Shapes](#api-shapes); see [references/curl-shell-compatibility.md](references/curl-shell-compatibility.md) for shell-specific details. ### API Shapes #### Bash-compatible Examples ```bash # Bash-compatible examples for macOS, Linux, WSL, and Git Bash. # On Windows, use the PowerShell command shape below and replace endpoint/query parameters. # Search skills curl -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \ --data-urlencode 'keyword=' \ --data-urlencode 'searchMode=semantic' \ --data-urlencode 'maxResults=20' \ -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \ -H 'x-acs-version: 2026-03-17' \ -H "x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)" # List categories curl -sS --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/categories' \ -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \ -H 'x-acs-version: 2026-03-17' \ -H "x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)" # Get skill content curl -sS --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills/' \ -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \ -H 'x-acs-version: 2026-03-17' \ -H "x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)" ``` #### Windows PowerShell Search Example Use this command shape on Windows and replace only query parameters as needed: ```powershell powershell -NoProfile -Command "curl.exe -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' --data-urlencode 'keyword=' --data-urlencode 'searchMode=semantic' --data-urlencode 'maxResults=20' -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' -H 'x-acs-version: 2026-03-17' -H ('x-acs-date: ' + [DateTimeOffset]::UtcNow.ToString('yyyy-MM-ddTHH:mm:ssZ'))" ``` ## Core Workflow ### Step 1: Understand What They Need Before searching, identify: 1. **Domain** — The relevant area or Alibaba Cloud product family, e.g., ECS, RDS, OSS, SLS, PAI, testing, deployment, data analysis. 2. **Specific task** — What the user wants to do, e.g., diagnose ECS issues, sync files to OSS, build a data analysis project, review permissions. 3. **Skill likelihood** — Whether this is a common enough task that an existing Skill likely exists. 4. **Category fit** — Whether the domain obviously maps to a known category. Call `/openapi/for-agent/categories` when the user asks to browse categories or when a `categoryCode` must be confirmed; otherwise avoid category calls during initial understanding. Use this understanding to choose the request shape first, then form search text only when using a keyword or semantic request. `keyword` supports both short keywords and full intent phrases. Because `searchMode=semantic` matches Skill descriptions, prefer the user's intent when available, such as `建一个数据分析项目`, instead of reducing every request to a single product word. Before searching, convert this analysis into searchable intent units using [Intent Analysis for Search](#1-intent-analysis-for-search). For compound requests, each meaningful requirement or support need must become its own searchable intent unit and be searched independently. The `Search Phrase` must be capability-oriented. It should not simply copy the user's surface wording unless the surface wording already names the capability, product, or service clearly. If a search phrase is mostly domain-specific labels, document titles, organization-specific terms, policy names, or private/internal terminology, rewrite it toward the underlying capability before searching. ### Step 2: Search Skills Choose from the command shapes below based on the request and available category context. For broad product-family discovery, confirm category context before keyword search, then use category listing or category-scoped search. Default to semantic intent search for task-matching requests without useful category context. - **Intent search (default for task matching)**: Use the user's task or full intent phrase as `keyword`, with `searchMode=semantic`. - **Keyword search**: Use concise product/task keywords with `searchMode=semantic` when the intent is broad, noisy, or already names a product/capability. - **Category browsing**: Call `/openapi/for-agent/categories` when the user asks for available categories or when a category code must be confirmed. - **List skills in a category**: Use `categoryCode` only. Do not pass `keyword` or `searchMode=semantic`; this mode supports pagination. - **Combined semantic search**: After category selection, use both `keyword` and `categoryCode` with `searchMode=semantic` only when the user asks for best matches inside that category. Choose one request shape based on the user request: ```bash # Bash-compatible examples for macOS, Linux, WSL, and Git Bash. # On Windows, use the PowerShell command shape above and replace endpoint/query parameters. # Intent or keyword search curl -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \ --data-urlencode 'keyword=' \ --data-urlencode 'searchMode=semantic' \ --data-urlencode 'maxResults=20' \ -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \ -H 'x-acs-version: 2026-03-17' \ -H "x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)" # Get all categories before listing skills in a category curl -sS --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/categories' \ -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \ -H 'x-acs-version: 2026-03-17' \ -H "x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)" # List skills in a category curl -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \ --data-urlencode 'categoryCode=' \ --data-urlencode 'maxResults=20' \ -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \ -H 'x-acs-version: 2026-03-17' \ -H "x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)" # Fetch the next category page if nextToken is returned curl -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \ --data-urlencode 'categoryCode=' \ --data-urlencode 'maxResults=20' \ --data-urlencode 'nextToken=' \ -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \ -H 'x-acs-version: 2026-03-17' \ -H "x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)" # Combined semantic search after category selection curl -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \ --data-urlencode 'keyword=' \ --data-urlencode 'categoryCode=' \ --data-urlencode 'searchMode=semantic' \ --data-urlencode 'maxResults=20' \ -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \ -H 'x-acs-version: 2026-03-17' \ -H "x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)" ``` ### Step 3: Iterate Until Found If a searchable intent unit has no clearly covering Skill, or the results are weak, overly generic, or only match surface/domain-specific wording, revise the search phrase and retry automatically before declaring a gap: 1. Start with the user's full intent phrase when available 2. Extract direct product/task keywords from the request 3. Switch between Chinese and English terms ("cloud server" → "ECS", "object storage" → "OSS") 4. Broaden or simplify keywords (drop qualifiers: "RDS backup automation" → "RDS") 5. Use `/openapi/for-agent/categories`, select the best category, then retry with combined search 6. Try synonyms or related terms ("instance" → "ECS", "bucket" → "OSS") Do not conclude "no dedicated Skill exists" until you have tried at least one capability-oriented search phrase for that intent unit. Repeat until every searchable intent unit has a clearly covering Skill, is covered by a complementary selected Skill, or is confirmed as a known gap. If all attempts fail for an intent unit, inform the user what was tried. ### Step 4: View Skill Details (Optional) Optionally retrieve skill content to verify it matches user intent before installation. This step can be skipped if the search results already provide sufficient information. ```bash # Bash-compatible example for macOS, Linux, WSL, and Git Bash. # On Windows, use the PowerShell command shape above and replace endpoint/query parameters. curl -sS --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills/' \ -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \ -H 'x-acs-version: 2026-03-17' \ -H "x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)" ``` ### Step 5: Install Selected Skill(s) Skip this step when the user only asks to list, browse, compare, or inspect Skills without installation. When installation is requested, execute the installation command for each selected Skill. ```bash # Option A: Using npx skills add # By default this command is interactive (blocks for user input). # Recommended: use non-interactive mode to avoid blocking. # --agent Agent client to install for (see references/npx-skills-agents.md) # -g Install globally (home dir); omit for project-local install # -y Skip confirmation (requires --agent and -g/-local to be set) npx skills add aliyun/alibabacloud-aiops-skills \ --skill \ --full-depth \ --agent qwen-code \ -g -y # Option B: Using npx clawhub install (OpenClaw ecosystem) npx clawhub install ``` Verify each selected Skill appears in the available skills list after installation. ## API Reference For complete HTTP parameter details and search parameter rules, see [references/agentexplorer-api.md](references/agentexplorer-api.md). ## Success Verification After each operation, verify success by checking: 1. **List Categories**: Response contains `data` with category `code` and `name` fields 2. **Search Skills**: Response contains `data` with valid skill objects 3. **Get Skill Content**: Response contains complete skill markdown `content` 4. **Install Selected Skill(s)**: Each selected Skill appears in the available skills list For detailed verification steps, see [references/verification-method.md](references/verification-method.md). ## Search Strategies ### 1. Intent Analysis for Search Before choosing search text, analyze the user's request into searchable intent units. A searchable intent unit should describe what capability the Skill must provide, not only the user's surface wording. For each meaningful requirement, identify: - **Action**: What operation is needed, e.g., query, generate, diagnose, deploy, install, validate, transform - **Object**: What the operation applies to, e.g., document, knowledge base, video, script, database, CLI environment - **Context/source**: Where the information or resource comes from, e.g., internal docs, cloud service, local file, OSS, database, runtime environment - **Expected output**: What the user expects back, e.g., answer with citations, generated script, report, command guidance, installed dependency - **Support needs**: Whether the request also needs plugins, runtime dependencies, environment checks, or troubleshooting Treat explicit support, blocker, and fallback clauses as searchable intents, even when they are conditional. This includes requirements about setup, dependencies, runtime environment, plugins, connectivity, validation, troubleshooting, remediation, or handling errors that may occur during execution. Do not drop these clauses just because they are not the primary business goal; if they may require a separate Skill, search them independently. Then form one or more searchable intent phrases using: ` +

Alibabacloud Find Skills

Description

Latest Changes

Install Alibabacloud Find Skills with One Click