{"id":"ba8e6e2f-7fc4-4bf8-a8ce-29742d0c1f69","entityType":"agent","slug":"clawhub-sdk-team-alibabacloud-find-skills","name":"Alibabacloud Find Skills","canonicalUrl":"https://www.xpersona.co/agent/clawhub-sdk-team-alibabacloud-find-skills","canonicalPath":"/agent/clawhub-sdk-team-alibabacloud-find-skills","generatedAt":"2026-10-09T23:29:53.231Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T18:27:56.901Z","emptyReason":null},"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 aliclou...","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 2.1K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s173swjet2yrebzqrp6hjkvmy583mxef:alibabacloud-find-skills","sourceUrl":"https://clawhub.ai/sdk-team/alibabacloud-find-skills","homepage":"https://clawhub.ai/sdk-team/skills/alibabacloud-find-skills","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/sdk-team/alibabacloud-find-skills","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/sdk-team/skills/alibabacloud-find-skills","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":40,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Alibabacloud Find Skills technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T18:27:56.901Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T18:27:56.901Z","emptyReason":null},"stars":null,"forks":null,"downloads":2132,"packageName":null,"latestVersion":"0.0.10","tractionLabel":"2.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T18:27:56.901Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T18:27:56.901Z","lastCrawledAt":"2026-10-09T18:27:56.901Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T18:27:56.901Z","lastVerifiedAt":null,"highlights":[{"version":"0.0.10","createdAt":"2026-06-24T07:09:11.478Z","changelog":"alibabacloud-find-skills 0.0.10 - Removed all instructions and code referencing the dynamic x-acs-date header in API calls; date header is no longer required. - Updated shell and PowerShell curl command examples to match the simplified API header requirements. - Revised documentation and references to reflect the new API request format. - Removed the file skill-card.md for further simplification. - Made minor clarifications and consistency improvements across documentation files.","fileCount":10,"zipByteSize":20025},{"version":"0.0.9","createdAt":"2026-06-09T09:51:01.630Z","changelog":"**Major update: Now uses direct HTTP API instead of Aliyun CLI for skill discovery.** - Switched search and discovery from Aliyun CLI plugin to direct AgentExplorer HTTP API with `curl` for all search/browse/detail workflows. - Added shell/OS-specific instructions and examples for `curl` usage, including full HTTP header and compatibility notes for macOS, Linux, and Windows. - Removed installation, update, and authentication instructions for the CLI and AgentExplorer plugin. - Updated workflows for API-based discovery, clarifying header, timeout, and date requirements. - Removed references to RAM policy, CLI configuration, and plugin management.","fileCount":10,"zipByteSize":21127},{"version":"0.0.8","createdAt":"2026-06-02T08:45:54.183Z","changelog":"alibabacloud-find-skills 0.0.8 - Added endpoint override requirement for all agentexplorer commands (`--endpoint 'agentexplorer.aliyuncs.com'`) - Improved search logic to prefer semantic intent-based matching rather than only keywords or categories - Enhanced instructions to cover searching with full user intent phrases and handling compound/complex requests - Added new reference: `references/search-examples.md` for better search guidance; removed obsolete `skill-card.md` - Clarified that skills are to be installed only when explicitly requested by the user - Updated and expanded documentation examples and workflow guidance throughout","fileCount":11,"zipByteSize":34746},{"version":"0.0.7","createdAt":"2026-05-29T08:22:59.243Z","changelog":"alibabacloud-find-skills v0.0.7 - Updated documentation and references files for clarity and accuracy. - Removed the skill-card.md file to streamline skill assets. - No functional or API changes; this is a documentation and reference update.","fileCount":10,"zipByteSize":31145},{"version":"0.0.6","createdAt":"2026-04-29T06:19:55.855Z","changelog":"- Added explicit stepwise workflow: Search, Install, Execute — now shown at the top for clarity. - Expanded trigger phrases and query examples to broaden discoverability and use cases. - Added a new reference: `references/npx-skills-agents.md`. - Updated documentation for improved guidance on finding and installing Alibaba Cloud Agent Skills. - Minor improvements to prompts, step ordering, and clarity throughout.","fileCount":10,"zipByteSize":31179},{"version":"0.0.5","createdAt":"2026-04-28T01:51:41.364Z","changelog":"alibabacloud-find-skills v0.0.5 - Added requirement to specify `--region cn-hangzhou` for all API calls (`aliyun agentexplorer ...`); calls without a region will now fail. - Clarified that `--user-agent` must only be used with OpenAPI-invoking commands, not local CLI commands like `aliyun configure` or `aliyun plugin`. - Improved installation and authentication instructions for clarity and separation of steps. - Updated and streamlined prerequisite checks and plugin management steps. - Removed the local validation script (`scripts/validate-skill.sh`).","fileCount":8,"zipByteSize":28823},{"version":"0.0.4","createdAt":"2026-04-22T07:56:10.059Z","changelog":"- Increased minimum required Aliyun CLI version to 3.3.3 and updated installation command/instructions. - Added requirement to always include the full user-agent string `AlibabaCloud-Agent-Skills/alibabacloud-find-skills` in every CLI call. - Clarified that after installation, plugins must be updated using `aliyun plugin update`. - Updated all CLI usage examples to use the new user-agent value. - Improved documentation for AI-Mode configuration and CLI upgrade verification steps.","fileCount":9,"zipByteSize":29680},{"version":"0.0.3","createdAt":"2026-04-16T11:42:37.017Z","changelog":"**alibabacloud-find-skills v0.0.3 – Update Highlights** - Added instructions for enabling and configuring Aliyun CLI AI-Mode. - Introduced plugin update guidance for staying current with latest features and fixes. - Improved search workflow: skills can now be found using both keyword and category with automatic retry strategies (including language switching and synonyms). - Simplified and clarified core usage steps and removed redundant parameter confirmation requirements. - Now supports multiple installation command options, including `npx clawhub install`. - Enhanced skill for more robust search and install flows based on user input and intent.","fileCount":9,"zipByteSize":29465}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s173swjet2yrebzqrp6hjkvmy583mxef:alibabacloud-find-skills","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s173swjet2yrebzqrp6hjkvmy583mxef:alibabacloud-find-skills` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/sdk-team/alibabacloud-find-skills before using production credentials."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sdk-team-alibabacloud-find-skills/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sdk-team-alibabacloud-find-skills/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sdk-team-alibabacloud-find-skills/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-sdk-team-alibabacloud-find-skills/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-sdk-team-alibabacloud-find-skills/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-sdk-team-alibabacloud-find-skills/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T23:29:53.228Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sdk-team-alibabacloud-find-skills/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sdk-team-alibabacloud-find-skills/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sdk-team-alibabacloud-find-skills/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sdk-team-alibabacloud-find-skills/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T18:27:56.901Z","emptyReason":null},"readme":"Skill: Alibabacloud Find Skills\n\nOwner: sdk-team\n\nSummary: Use this skill when users want to search, discover, browse, or find Alibaba Cloud (阿里云) agent skills. Triggers include: \"find a skill for X\", \"search aliclou...\n\nTags: latest:0.0.10\n\nVersion history:\n\nv0.0.10 | 2026-06-24T07:09:11.478Z | auto\n\nalibabacloud-find-skills 0.0.10\n\n- Removed all instructions and code referencing the dynamic x-acs-date header in API calls; date header is no longer required.\n- Updated shell and PowerShell curl command examples to match the simplified API header requirements.\n- Revised documentation and references to reflect the new API request format.\n- Removed the file skill-card.md for further simplification.\n- Made minor clarifications and consistency improvements across documentation files.\n\nv0.0.9 | 2026-06-09T09:51:01.630Z | auto\n\n**Major update: Now uses direct HTTP API instead of Aliyun CLI for skill discovery.**\n\n- Switched search and discovery from Aliyun CLI plugin to direct AgentExplorer HTTP API with `curl` for all search/browse/detail workflows.\n- Added shell/OS-specific instructions and examples for `curl` usage, including full HTTP header and compatibility notes for macOS, Linux, and Windows.\n- Removed installation, update, and authentication instructions for the CLI and AgentExplorer plugin.\n- Updated workflows for API-based discovery, clarifying header, timeout, and date requirements.\n- Removed references to RAM policy, CLI configuration, and plugin management.\n\nv0.0.8 | 2026-06-02T08:45:54.183Z | auto\n\nalibabacloud-find-skills 0.0.8\n\n- Added endpoint override requirement for all agentexplorer commands (`--endpoint 'agentexplorer.aliyuncs.com'`)\n- Improved search logic to prefer semantic intent-based matching rather than only keywords or categories\n- Enhanced instructions to cover searching with full user intent phrases and handling compound/complex requests\n- Added new reference: `references/search-examples.md` for better search guidance; removed obsolete `skill-card.md`\n- Clarified that skills are to be installed only when explicitly requested by the user\n- Updated and expanded documentation examples and workflow guidance throughout\n\nv0.0.7 | 2026-05-29T08:22:59.243Z | auto\n\nalibabacloud-find-skills v0.0.7\n\n- Updated documentation and references files for clarity and accuracy.\n- Removed the skill-card.md file to streamline skill assets.\n- No functional or API changes; this is a documentation and reference update.\n\nv0.0.6 | 2026-04-29T06:19:55.855Z | auto\n\n- Added explicit stepwise workflow: Search, Install, Execute — now shown at the top for clarity.\n- Expanded trigger phrases and query examples to broaden discoverability and use cases.\n- Added a new reference: `references/npx-skills-agents.md`.\n- Updated documentation for improved guidance on finding and installing Alibaba Cloud Agent Skills.\n- Minor improvements to prompts, step ordering, and clarity throughout.\n\nv0.0.5 | 2026-04-28T01:51:41.364Z | auto\n\nalibabacloud-find-skills v0.0.5\n\n- Added requirement to specify `--region cn-hangzhou` for all API calls (`aliyun agentexplorer ...`); calls without a region will now fail.\n- Clarified that `--user-agent` must only be used with OpenAPI-invoking commands, not local CLI commands like `aliyun configure` or `aliyun plugin`.\n- Improved installation and authentication instructions for clarity and separation of steps.\n- Updated and streamlined prerequisite checks and plugin management steps.\n- Removed the local validation script (`scripts/validate-skill.sh`).\n\nv0.0.4 | 2026-04-22T07:56:10.059Z | auto\n\n- Increased minimum required Aliyun CLI version to 3.3.3 and updated installation command/instructions.\n- Added requirement to always include the full user-agent string `AlibabaCloud-Agent-Skills/alibabacloud-find-skills` in every CLI call.\n- Clarified that after installation, plugins must be updated using `aliyun plugin update`.\n- Updated all CLI usage examples to use the new user-agent value.\n- Improved documentation for AI-Mode configuration and CLI upgrade verification steps.\n\nv0.0.3 | 2026-04-16T11:42:37.017Z | auto\n\n**alibabacloud-find-skills v0.0.3 – Update Highlights**\n\n- Added instructions for enabling and configuring Aliyun CLI AI-Mode.\n- Introduced plugin update guidance for staying current with latest features and fixes.\n- Improved search workflow: skills can now be found using both keyword and category with automatic retry strategies (including language switching and synonyms).\n- Simplified and clarified core usage steps and removed redundant parameter confirmation requirements.\n- Now supports multiple installation command options, including `npx clawhub install`.\n- Enhanced skill for more robust search and install flows based on user input and intent.\n\nv0.0.2 | 2026-04-02T02:44:25.004Z | auto\n\nalibabacloud-find-skills 0.0.2\n\n- Corrected the skill installation command to use the appropriate skill package name.\n- Minor updates to workflow descriptions for accuracy and clarity.\n- No major functional or breaking changes.\n\nv0.0.1 | 2026-03-30T08:24:49.485Z | auto\n\nInitial release.\n\n- Enables users to search, browse, and discover Alibaba Cloud agent skills via the agentexplorer CLI plugin.\n- Supports finding skills by keyword, category, or both, with paginated search.\n- Provides workflows to view skill details and install skills.\n- Includes clear installation and authentication instructions.\n- Outlines required permissions and parameter confirmation before API calls.\n\nv0.0.1-beta.6 | 2026-03-30T08:12:36.590Z | auto\n\nNo functional or content changes detected in this version.\n\n- No file changes were made compared to the previous version.\n- Skill behavior and documentation remain unchanged.\n\nv0.0.1-beta.5 | 2026-03-30T06:55:22.414Z | auto\n\nNo user-facing changes in this version.\n\n- No file changes detected.\n- Skill functionality and documentation remain the same as the previous version.\n\nv0.0.1-beta.4 | 2026-03-30T06:08:01.668Z | auto\n\n- Added detailed documentation for searching, browsing, and installing Alibaba Cloud agent skills.\n- Included comprehensive workflows for skill discovery, detail retrieval, and installation.\n- Specified required Alibaba Cloud CLI version, dependency on the agentexplorer plugin, and strict credential handling.\n- Listed required RAM permissions and included security and confirmation protocols.\n- Outlined user parameter confirmation requirements for all commands and workflows.\n\nArchive index:\n\nArchive v0.0.10: 10 files, 20025 bytes\n\nFiles: references/acceptance-criteria.md (7616b), references/agentexplorer-api.md (6451b), references/category-examples.md (4072b), references/curl-shell-compatibility.md (1773b), references/npx-skills-agents.md (798b), references/search-examples.md (5835b), references/verification-method.md (6161b), skill-card.md (2506b), SKILL.md (22736b), _meta.json (144b)\n\nFile v0.0.10:SKILL.md\n\n---\nname: alibabacloud-find-skills\ndescription: >\n  Use this skill when users want to search, discover, browse, or find Alibaba Cloud (阿里云) agent skills.\n  Triggers include: \"find a skill for X\", \"search alicloud skills\", \"阿里云有什么 skill\",\"阿里云\",\n  \"搜索阿里云技能\", \"有没有管理 ECS/RDS/OSS 的 skill\", \"阿里云 skills 有哪些类目\",\n  \"帮我找一个 skill\", \"browse alicloud skills\", \"list alicloud skill categories\",\n  \"is there an alicloud skill that can...\", \"what alicloud skills are available\", \"XX Skill 的内容是什么\", \"我想了解阿里云 XX Skill 具体做什么\",\"帮我安装阿里云 Skill\",\"使用阿里云相关的skill\",\n  \"阿里云 agent skill 市场\", \"搜一下阿里云的 skill\", \"建一个数据分析项目有没有相关 skill\".\n---\n\n> [!IMPORTANT]\n> **For any Alibaba Cloud query or management task:**\n> 1. **Search** — use this skill (`alibabacloud-find-skills`) to find the relevant Skill(s).\n> 2. **Install** — install the selected Skill(s) only when the user asks to install or use them to complete the task.\n> 3. **Execute** — follow the installed Skill(s)' instructions to fulfill the request.\n\n# Alibaba Cloud Agent Skills Search & Discovery\n\nThis skill helps users search, discover, and install Alibaba Cloud official Agent Skills from the AgentExplorer catalog.\n\n## Scenario Description\n\nThis skill enables users to:\n\n1. **Search Skills** — Find Alibaba Cloud Agent Skills by intent phrase, keyword, category listing, or combined semantic search\n2. **Browse Categories** — Explore available skill categories and subcategories\n3. **View Skill Details** — Get detailed information about specific skills\n4. **Install Skills** — Guide users through skill installation when installation is requested\n\n**Architecture**: `curl` + AgentExplorer HTTP API → Skills Repository\n\nDiscovery 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.\n\n### Use Cases\n\n- \"Find a skill for managing ECS instances\"\n- \"What Alibaba Cloud skills are available for databases?\"\n- \"阿里云有哪些 OSS 相关的 skill?\"\n- \"Browse all available alicloud skills\"\n- \"Install a skill for RDS management\"\n\n## AgentExplorer HTTP API\n\n**Base URL**: `https://agentexplorer.aliyuncs.com`\n\nEvery AgentExplorer HTTP request must include these headers.\n\n```bash\n# Bash-compatible header snippet for macOS, Linux, WSL, and Git Bash.\n# On Windows, use the PowerShell command shape below instead.\n-H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n-H 'x-acs-version: 2026-03-17'\n```\n\nEvery AgentExplorer HTTP `curl` / `curl.exe` request must include `--connect-timeout 10 --max-time 30`.\n\n### Shell-compatible curl usage\n\nBefore 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.\n\n### API Shapes\n\n#### Bash-compatible Examples\n\n```bash\n# Bash-compatible examples for macOS, Linux, WSL, and Git Bash.\n# On Windows, use the PowerShell command shape below and replace endpoint/query parameters.\n\n# Search skills\ncurl -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=<user-intent-or-keyword>' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n\n# List categories\ncurl -sS --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/categories' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n\n# Get skill content\ncurl -sS --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills/<skillName>' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n#### Windows PowerShell Search Example\n\nUse this command shape on Windows and replace only query parameters as needed:\n\n```powershell\npowershell -NoProfile -Command \"curl.exe -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' --data-urlencode 'keyword=<user-intent-or-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'\"\n```\n\n## Core Workflow\n\n### Step 1: Understand What They Need\n\nBefore searching, identify:\n\n1. **Domain** — The relevant area or Alibaba Cloud product family, e.g., ECS, RDS, OSS, SLS, PAI, testing, deployment, data analysis.\n2. **Specific task** — What the user wants to do, e.g., diagnose ECS issues, sync files to OSS, build a data analysis project, review permissions.\n3. **Skill likelihood** — Whether this is a common enough task that an existing Skill likely exists.\n4. **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.\n\nUse 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.\n\nBefore 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.\n\nThe `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.\n\nIf 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.\n\n### Step 2: Search Skills\n\nChoose 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.\n\n- **Intent search (default for task matching)**: Use the user's task or full intent phrase as `keyword`, with `searchMode=semantic`.\n- **Keyword search**: Use concise product/task keywords with `searchMode=semantic` when the intent is broad, noisy, or already names a product/capability.\n- **Category browsing**: Call `/openapi/for-agent/categories` when the user asks for available categories or when a category code must be confirmed.\n- **List skills in a category**: Use `categoryCode` only. Do not pass `keyword` or `searchMode=semantic`; this mode supports pagination.\n- **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.\n\nChoose one request shape based on the user request:\n\n```bash\n# Bash-compatible examples for macOS, Linux, WSL, and Git Bash.\n# On Windows, use the PowerShell command shape above and replace endpoint/query parameters.\n\n# Intent or keyword search\ncurl -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=<user-intent-or-keyword>' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n\n# Get all categories before listing skills in a category\ncurl -sS --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/categories' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n\n# List skills in a category\ncurl -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=<category-code>' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n\n# Fetch the next category page if nextToken is returned\ncurl -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=<category-code>' \\\n  --data-urlencode 'maxResults=20' \\\n  --data-urlencode 'nextToken=<next-token-from-previous-response>' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n\n# Combined semantic search after category selection\ncurl -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=<user-intent-or-keyword>' \\\n  --data-urlencode 'categoryCode=<category-code>' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n### Step 3: Iterate Until Found\n\nIf 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:\n\n1. Start with the user's full intent phrase when available\n2. Extract direct product/task keywords from the request\n3. Switch between Chinese and English terms (\"cloud server\" → \"ECS\", \"object storage\" → \"OSS\")\n4. Broaden or simplify keywords (drop qualifiers: \"RDS backup automation\" → \"RDS\")\n5. Use `/openapi/for-agent/categories`, select the best category, then retry with combined search\n6. Try synonyms or related terms (\"instance\" → \"ECS\", \"bucket\" → \"OSS\")\n\nDo not conclude \"no dedicated Skill exists\" until you have tried at least one capability-oriented search phrase for that intent unit.\n\nRepeat 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.\n\n### Step 4: View Skill Details (Optional)\n\nOptionally retrieve skill content to verify it matches user intent before installation. This step can be skipped if the search results already provide sufficient information.\n\n```bash\n# Bash-compatible example for macOS, Linux, WSL, and Git Bash.\n# On Windows, use the PowerShell command shape above and replace endpoint/query parameters.\n\ncurl -sS --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills/<skillName>' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n### Step 5: Install Selected Skill(s)\n\nSkip 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.\n\n```bash\n# Option A: Using npx skills add\n# By default this command is interactive (blocks for user input).\n# Recommended: use non-interactive mode to avoid blocking.\n#   --agent <client>   Agent client to install for (see references/npx-skills-agents.md)\n#   -g                 Install globally (home dir); omit for project-local install\n#   -y                 Skip confirmation (requires --agent and -g/-local to be set)\nnpx skills add aliyun/alibabacloud-aiops-skills \\\n  --skill <skill-name> \\\n  --full-depth \\\n  --agent qwen-code \\\n  -g -y\n\n# Option B: Using npx clawhub install (OpenClaw ecosystem)\nnpx clawhub install <selected-skill-name>\n```\n\nVerify each selected Skill appears in the available skills list after installation.\n\n## API Reference\n\nFor complete HTTP parameter details and search parameter rules, see [references/agentexplorer-api.md](references/agentexplorer-api.md).\n\n## Success Verification\n\nAfter each operation, verify success by checking:\n\n1. **List Categories**: Response contains `data` with category `code` and `name` fields\n2. **Search Skills**: Response contains `data` with valid skill objects\n3. **Get Skill Content**: Response contains complete skill markdown `content`\n4. **Install Selected Skill(s)**: Each selected Skill appears in the available skills list\n\nFor detailed verification steps, see [references/verification-method.md](references/verification-method.md).\n\n## Search Strategies\n\n### 1. Intent Analysis for Search\n\nBefore 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.\n\nFor each meaningful requirement, identify:\n\n- **Action**: What operation is needed, e.g., query, generate, diagnose, deploy, install, validate, transform\n- **Object**: What the operation applies to, e.g., document, knowledge base, video, script, database, CLI environment\n- **Context/source**: Where the information or resource comes from, e.g., internal docs, cloud service, local file, OSS, database, runtime environment\n- **Expected output**: What the user expects back, e.g., answer with citations, generated script, report, command guidance, installed dependency\n- **Support needs**: Whether the request also needs plugins, runtime dependencies, environment checks, or troubleshooting\n\nTreat 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.\n\nThen form one or more searchable intent phrases using:\n\n`<action> + <object/capability> + <context/source> + <expected output>`\n\nFor compound requests, create one searchable intent unit per meaningful requirement and search each unit independently. Do not assume one Skill covers the whole request unless the search result clearly states that it does.\n\nA single searchable intent unit may still require multiple complementary Skills. When one Skill covers the main action but another Skill is needed for supporting needs such as plugins, runtime setup, data access, or validation, select both and explain their roles separately.\n\n### 2. Search Text Selection\n\n- **Use intent phrases first**: Prefer the user's natural-language task or requirement, e.g., \"建一个数据分析项目\", \"把本地文件同步到 OSS\"\n- **Use product/task keywords when intent is broad or noisy**: Extract concise product and action terms, e.g., \"ECS 诊断\", \"OSS 同步\"\n- **Use product codes as fallback or refinement**: `ecs`, `rds`, `oss`, `slb`, `vpc`\n- **Use Chinese and English variants**: e.g., \"云服务器\" / \"ECS\", \"对象存储\" / \"OSS\"\n- **Use broader terms only after specific intent searches fail**: e.g., \"compute\", \"storage\", \"network\"\n\n### 3. Category Filtering\n\n- **Browse when needed**: Use `/openapi/for-agent/categories` when the user asks about categories or when the domain should narrow the search\n- **Select the best category**: Map the domain to the closest `categoryCode`, then pass it as `categoryCode`\n- **Combine with intent**: For clear tasks inside a clear domain, use the task phrase as `keyword` and the selected category as `categoryCode`\n\n### 4. Result Optimization\n\n- **Start with intent**: Begin with the user's task description, then add category filtering only when the domain is clear or initial results are too broad\n- **Keep complementary Skills together**: If one Skill handles the main task and another handles required setup, access, validation, or troubleshooting, include both instead of choosing only the top-ranked main Skill\n- **Check install counts**: Popular skills usually have higher install counts\n- **Read descriptions**: Match skill description to your specific use case\n\n### 5. When No Results Found\n\n```bash\n# Bash-compatible examples for macOS, Linux, WSL, and Git Bash.\n# On Windows, use the PowerShell command shape above and replace endpoint/query parameters.\n\n# Strategy 1: Try the full user intent\n# Instead of just \"OSS\", try \"把本地文件同步到 OSS\"\n\n# Strategy 2: Extract product/task keywords\n# Instead of \"云服务器故障排查\", try \"ECS 诊断\"\n\n# Strategy 3: Try Chinese and English variants\n# Instead of \"云服务器\" try \"ECS\" or \"instance\"\n\n# Strategy 4: Use broader terms\n# Instead of \"RDS backup automation\" try just \"RDS\" or \"database\"\n\n# Strategy 5: Browse or filter by category\ncurl -sS --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/categories' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n\ncurl -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=ECS 实例管理' \\\n  --data-urlencode 'categoryCode=<selected-category-code>' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n### 6. Display Results to Users\n\nWhen presenting search results, format as table:\n\n```\nFound N skills:\n\n| Skill Name | Display Name | Description | Category | Install Count |\n|------------|--------------|-------------|----------|---------------|\n| alibabacloud-ecs-batch | ECS Batch Operations | Batch manage ECS instances | Computing > ECS | 245 |\n| ... | ... | ... | ... | ... |\n```\n\nInclude:\n\n- **skillName**: For installation and detailed queries\n- **displayName**: User-friendly name\n- **description**: Brief overview\n- **categoryName** + **subCategoryName**: Classification\n- **installCount**: Popularity indicator\n\n## Cleanup\n\nThis skill does not create any resources. No cleanup is required.\n\n## Best Practices\n\n1. **Choose the right search mode** — Use semantic intent or keyword search for task matching; use category listing without `searchMode=semantic` when the user asks to list all Skills in a category\n2. **Search by intent units** — Split compound requests into meaningful capability and support needs, then search each unit independently\n3. **Refine weak results** — If results only match surface wording or miss an intent unit, rewrite the phrase toward the underlying capability and retry before declaring a gap\n4. **Keep complementary Skills together** — Select multiple Skills when one covers the main task and another covers required setup, access, validation, troubleshooting, or runtime support\n5. **Display results clearly** — Use tables with `skillName`, display name, category, description, and install count\n6. **Install only when requested** — Do not install for list-only, browse-only, or compare-only requests\n7. **Verify before installation** — Use the skill content endpoint when search results are not sufficient to confirm fit\n8. **Verify after installation** — Confirm every selected Skill is available after installation\n\n## Common Use Cases & Examples\n\nFor examples, see [references/search-examples.md](references/search-examples.md).\n\n## Reference Documentation\n\n| Reference                                                              | Description                                  |\n| ---------------------------------------------------------------------- | -------------------------------------------- |\n| [references/agentexplorer-api.md](references/agentexplorer-api.md)     | Complete AgentExplorer HTTP API reference    |\n| [references/verification-method.md](references/verification-method.md) | Success verification steps for each workflow |\n| [references/acceptance-criteria.md](references/acceptance-criteria.md) | Testing acceptance criteria and patterns     |\n| [references/category-examples.md](references/category-examples.md)     | Common category codes and examples           |\n| [references/search-examples.md](references/search-examples.md)         | Common search workflow examples              |\n| [references/curl-shell-compatibility.md](references/curl-shell-compatibility.md) | Shell-specific curl command templates        |\n| [references/npx-skills-agents.md](references/npx-skills-agents.md)     | Supported `--agent` values for `npx skills add` |\n\n## Troubleshooting\n\nIf PowerShell reports `Invoke-WebRequest` or parameter-binding errors, the command used the `curl` alias. Retry with `curl.exe`.\n\n### Error: DNS, connection, or TLS failure\n\n**Cause**: Network access to `agentexplorer.aliyuncs.com` failed.\n\n**Solutions**:\n\n1. Retry once; transient network failures are possible.\n2. Check proxy or network policy if running in a restricted agent sandbox.\n3. Do not switch to Aliyun CLI as a workaround unless the user explicitly asks.\n\n### No Results Returned\n\n**Cause**: Search mode, search phrase, or category code does not match the user's request.\n\n**Solutions**:\n\n1. For semantic intent search, rewrite the phrase toward the underlying capability instead of repeating private/internal wording\n2. Try Chinese and English variants, product codes, and concise product/task keywords\n3. For weak semantic results, retry with a selected `categoryCode` and `searchMode=semantic`\n4. For category listing, verify the `categoryCode` with `/openapi/for-agent/categories`, omit `keyword` and `searchMode`, and use `nextToken` when pagination is returned\n5. Declare a gap only after each searchable intent unit has been retried with at least one capability-oriented phrase\n\n## Notes\n\n- **Read-only operations**: This skill only performs queries, no resources are created\n- **No CLI prerequisite**: Discovery uses `curl`; downstream selected Skills may have their own CLI or permission requirements\n- **Multi-language support**: Keywords support both English and Chinese\n- **Regular updates**: Skills catalog is regularly updated with new skills\n- **Community skills**: Some skills may be community-contributed, check descriptions carefully\n\nFile v0.0.10:_meta.json\n\n{\n  \"ownerId\": \"kn74p5w8ywv6prh40g0s82gmqh83nw54\",\n  \"slug\": \"alibabacloud-find-skills\",\n  \"version\": \"0.0.10\",\n  \"publishedAt\": 1782284951478\n}\n\nFile v0.0.10:references/acceptance-criteria.md\n\n# Acceptance Criteria: alibabacloud-find-skills\n\n**Skill Name**: `alibabacloud-find-skills`\n**Purpose**: Validate correct AgentExplorer HTTP API usage and skill-discovery behavior.\n\n## Discovery Prerequisites\n\n### Correct\n\nThe discovery workflow uses `curl` directly:\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=ECS' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n### Incorrect\n\n```bash\naliyun version\naliyun plugin search agentexplorer\naliyun plugin install --names aliyun-cli-agentexplorer\naliyun plugin update --name aliyun-cli-agentexplorer\naliyun agentexplorer search-skills --keyword \"ECS\"\naliyun configure list\n```\n\n**Why**: Finding, browsing, and inspecting Skills uses direct HTTP requests and no longer requires Aliyun CLI or the AgentExplorer CLI plugin.\n\n## HTTP API Patterns\n\n### 1. Search Skills\n\n#### Correct\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=RDS backup automation' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n#### Incorrect\n\n```bash\n# Missing -G: query params are not appended as intended\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=RDS backup automation'\n\n# Wrong parameter names from CLI mode\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'search-mode=semantic' \\\n  --data-urlencode 'max-results=20'\n\n# Wrong endpoint path\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/search-skills'\n```\n\n**Why**: HTTP query parameters use API names such as `searchMode`, `maxResults`, `categoryCode`, and `nextToken`.\n\n### 2. List Categories\n\n#### Correct\n\n```bash\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/categories' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n#### Incorrect\n\n```bash\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/category'\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/list-categories'\n```\n\n### 3. Get Skill Content\n\n#### Correct\n\n```bash\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills/alibabacloud-cli-guidance' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n#### Incorrect\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'skillName=alibabacloud-cli-guidance'\n\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skill/alibabacloud-cli-guidance'\n```\n\n**Why**: Skill content uses a path parameter: `/openapi/for-agent/skills/{skillName}`.\n\n## Header Requirements\n\n### Correct\n\nEvery discovery API call includes both required headers:\n\n```bash\n-H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n-H 'x-acs-version: 2026-03-17'\n```\n\n### Incorrect\n\n```bash\n# Missing API version header\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=ECS' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills'\n\n# Wrong user agent\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=ECS' \\\n  -H 'User-Agent: MyAgent'\n\n# Wrong header shape for this workflow\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  -H 'x-acs-api-version: 2026-03-17'\n```\n\n**Why**: The skill user-agent is required for attribution. The API version header must be `x-acs-version`.\n\n## Search Parameter Rules\n\n### Correct\n\n```bash\n# Intent search\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=把本地文件同步到 OSS' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n\n# Category listing\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n\n# Combined semantic search\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=backup' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n### Incorrect\n\n```bash\n# Category listing should not use semantic mode\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'searchMode=semantic'\n\n# Multi-word values are not URL-encoded\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills?keyword=RDS backup automation'\n```\n\n## Pagination Rules\n\n### Correct\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'maxResults=20' \\\n  --data-urlencode 'nextToken=<next-token-from-previous-response>' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n### Incorrect\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'next-token=abc'\n\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'nextToken=page2'\n```\n\n**Why**: Use the API field name `nextToken`, and pass the returned token exactly.\n\n## Result Handling\n\n### Correct\n\nPresent users a concise table:\n\n```markdown\n| Skill Name | Display Name | Category | Install Count | Why it fits |\n| --- | --- | --- | ---: | --- |\n| alibabacloud-ecs-batch | ECS Batch Ops | 计算 > ECS | 245 | Handles batch ECS operations |\n```\n\n### Incorrect\n\n```bash\n# Dumping raw JSON without summarizing\necho \"$RESULT\"\n```\n\n## Installation Rules\n\n### Correct\n\nOnly install when the user asks to install or use a selected Skill:\n\n```bash\nnpx skills add aliyun/alibabacloud-aiops-skills \\\n  --skill <skill-name> \\\n  --full-depth \\\n  --agent qwen-code \\\n  -g -y\n```\n\n### Incorrect\n\n```bash\n# Installing during browse-only/search-only requests\nnpx skills add aliyun/alibabacloud-aiops-skills --skill <skill-name>\n```\n\n## Failure Handling\n\n- On network failure, retry once and report endpoint/network context.\n- On weak or empty results, rewrite the search phrase toward the underlying capability.\n- Do not tell the user to install or configure Aliyun CLI for this discovery workflow.\n\n## Final Checklist\n\n- [ ] Uses `curl`, not `aliyun`, for discovery\n- [ ] Uses `https://agentexplorer.aliyuncs.com/openapi/for-agent/skills` for search/listing\n- [ ] Uses `https://agentexplorer.aliyuncs.com/openapi/for-agent/categories` for categories\n- [ ] Uses `/openapi/for-agent/skills/{skillName}` for details\n- [ ] Includes `User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills`\n- [ ] Includes `x-acs-version: 2026-03-17`\n- [ ] Uses `--data-urlencode` for query parameters\n- [ ] Splits compound requests into searchable intent units\n- [ ] Installs selected Skills only when requested\n\nFile v0.0.10:references/agentexplorer-api.md\n\n# AgentExplorer HTTP API Reference\n\nComplete reference for HTTP requests used by the `alibabacloud-find-skills` skill.\n\nDiscovery uses `curl` directly. Do not install Aliyun CLI or the `agentexplorer` CLI plugin for this skill's search, browse, or detail workflows.\n\n## Common Request Headers\n\nEvery AgentExplorer request must include:\n\n```bash\n-H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n-H 'x-acs-version: 2026-03-17'\n```\n\nFor Windows PowerShell, Command Prompt, macOS, Linux, WSL, and Git Bash curl templates, see [curl-shell-compatibility.md](curl-shell-compatibility.md).\n\n## API Summary\n\n| API | Purpose | Required values |\n| --- | --- | --- |\n| `GET /openapi/for-agent/skills` | Search or list skills | Common headers; query params depend on mode |\n| `GET /openapi/for-agent/categories` | List skill categories | Common headers |\n| `GET /openapi/for-agent/skills/{skillName}` | Get skill details | Common headers; path `skillName` |\n\nBase URL:\n\n```text\nhttps://agentexplorer.aliyuncs.com\n```\n\n## 1. Search Or List Skills\n\n**Endpoint**:\n\n```text\nGET https://agentexplorer.aliyuncs.com/openapi/for-agent/skills\n```\n\n**Query parameters**:\n\n| Parameter | Required | Description |\n| --- | --- | --- |\n| `keyword` | No | Search keyword or full intent phrase |\n| `categoryCode` | No | Top-level category code, dot-form child category, or comma-separated category list |\n| `searchMode` | Conditional | Use `semantic` for intent/keyword/combined search; omit for pure category listing |\n| `maxResults` | No | Maximum results per page, default `20`, max `100` |\n| `nextToken` | No | Pagination token returned by the previous response |\n| `skip` | No | Number of records to skip; prefer `nextToken` for pagination |\n\n### Semantic Intent Or Keyword Search\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=<keyword-or-intent>' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n### List Skills In A Category\n\nUse when the user asks to list or browse all Skills under a category. Do not pass `keyword` or `searchMode=semantic`.\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=<category-code>' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\nFetch the next page only when `nextToken` is returned:\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=<category-code>' \\\n  --data-urlencode 'maxResults=20' \\\n  --data-urlencode 'nextToken=<next-token-from-previous-response>' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n### Combined Semantic Search\n\nUse only after category selection when the user asks for best matches inside a category.\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=<keyword-or-intent>' \\\n  --data-urlencode 'categoryCode=<category-code>' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n**Response shape**:\n\n```json\n{\n  \"data\": [\n    {\n      \"skillName\": \"alibabacloud-ecs-batch-command\",\n      \"displayName\": \"ECS 批量命令执行\",\n      \"description\": \"批量在多台 ECS 实例上执行命令\",\n      \"categoryCode\": \"computing\",\n      \"categoryName\": \"计算\",\n      \"subCategoryCode\": \"ecs\",\n      \"subCategoryName\": \"云服务器 ECS\",\n      \"installCount\": 245,\n      \"likeCount\": 18\n    }\n  ],\n  \"totalCount\": 100,\n  \"nextToken\": \"eyJwYWdlIjoyfQ==\",\n  \"maxResults\": 20,\n  \"requestId\": \"...\"\n}\n```\n\n## 2. List Categories\n\n**Endpoint**:\n\n```text\nGET https://agentexplorer.aliyuncs.com/openapi/for-agent/categories\n```\n\n**Example**:\n\n```bash\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/categories' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n**Response shape**:\n\n```json\n{\n  \"data\": [\n    {\n      \"code\": \"computing\",\n      \"name\": \"计算\",\n      \"children\": [\n        {\n          \"code\": \"ecs\",\n          \"name\": \"云服务器 ECS\"\n        }\n      ]\n    }\n  ],\n  \"requestId\": \"...\"\n}\n```\n\n## 3. Get Skill Content\n\n**Endpoint**:\n\n```text\nGET https://agentexplorer.aliyuncs.com/openapi/for-agent/skills/{skillName}\n```\n\n**Example**:\n\n```bash\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills/<skillName>' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n**Response shape**:\n\n```json\n{\n  \"requestId\": \"...\",\n  \"content\": \"---\\nname: alibabacloud-ecs-batch-command\\n...\"\n}\n```\n\n## Category Code Rules\n\n- Top-level category: use the category code directly, e.g. `computing`\n- Child category: use dot notation only when the API supports it for the target category, e.g. `computing.ecs`\n- Multiple categories: comma-separate category codes, e.g. `computing,database`\n- If a bare child category such as `ecs` does not filter as expected, use it as `keyword` or confirm the current category list first\n\n## Search Usage Patterns\n\nUse the same semantic-search shape for both keywords and full intent phrases:\n\n```bash\n# Keyword search\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=ECS' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n\n# Intent search\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=把本地文件同步到 OSS' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n## Notes\n\n- Do not use Aliyun CLI flags such as `--endpoint`, `--region`, `--user-agent`, or `--cli-query` in the HTTP workflow.\n- Use `jq` only if it is already available; otherwise inspect the JSON response directly and summarize the relevant fields.\n\nFile v0.0.10:references/category-examples.md\n\n# Category Examples\n\nThis reference provides common category codes and examples for navigating the Alibaba Cloud Agent Skills catalog.\n\nFor the complete, current category list, call:\n\n```bash\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/categories' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n## Category Code Format\n\n- Top-level category: use the category code directly, e.g. `computing`\n- Child category: when supported, use dot notation, e.g. `computing.ecs`\n- Multiple categories: comma-separate codes, e.g. `computing,database`\n- If child code filtering is uncertain, confirm with `/openapi/for-agent/categories`, then use either dot notation or a semantic `keyword`\n\n## Common Categories\n\n| Code | Name | Typical Domains |\n| --- | --- | --- |\n| `computing` | 计算 | ECS, ECI, EHPC, ComputeNest, Alibaba Cloud Linux |\n| `aiml` | 人工智能与机器学习 | PAI, Bailian, OpenSearch, AgentBay |\n| `developertools` | 开发工具 | CLI guidance, developer workflows |\n| `storage` | 存储 | OSS, SLS, Tablestore, PDS, HBR |\n| `migrationom` | 迁移与运维管理 | OOS, Terraform import, resource management |\n| `netcdn` | 网络与CDN | NIS, SAG, DCDN |\n| `middleware` | 中间件 | CMS, API Gateway, PTS, STAROps |\n| `doweb` | 域名与网站 | Domain, ICP filing, website building |\n| `security` | 安全 | SAS, WAF, KMS, CFW, DDoS |\n| `database` | 数据库 | RDS, PolarDB, Tair, MongoDB, DTS, DMS |\n| `analyticscomputing` | 大数据计算 | DataWorks, MaxCompute, Flink, Hologres, Elasticsearch, Milvus |\n| `entcmc` | 企业服务与云通信 | SMS, voice, Chat App |\n| `mediaservices` | 媒体服务 | Live, MTS, ICE |\n| `others` | 其他 | General solutions |\n| `playbooks` | 场景化实战 | Troubleshooting and optimization playbooks |\n| `solutions` | 阿里云级跨产品类目解决方案 | Cross-product solutions |\n\n## Example Searches\n\n### Browse A Top-Level Category\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n### Search Within A Category\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=RDS backup automation' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n### Try A Child Category Or Product Keyword\n\n```bash\n# Child category form, when supported\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=computing.ecs' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n\n# Product keyword fallback\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=ECS instance management' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n## Domain Mapping Hints\n\n| User Domain | Start With | Refinement Keywords |\n| --- | --- | --- |\n| ECS / servers | `computing` | ECS, instance, diagnosis, command, patch |\n| RDS / PolarDB / Redis | `database` | RDS, PolarDB, Tair, SQL, backup, performance |\n| OSS / files / logs | `storage` | OSS, SLS, upload, sync, index, media |\n| Data projects | `analyticscomputing` | DataWorks, MaxCompute, Flink, Hologres |\n| AI / RAG / knowledge base | `aiml` | Bailian, knowledge base, RAG, PAI |\n| Security | `security` | SAS, WAF, KMS, vulnerability, bot |\n| Network troubleshooting | `netcdn` | NIS, reachability, SAG, DCDN |\n| Deployment / operations | `migrationom` | OOS, Terraform, patch, import, resource |\n\nFile v0.0.10:references/curl-shell-compatibility.md\n\n# Curl Shell Compatibility Guide\n\nAgentExplorer HTTP APIs use the same URL, query parameters, and headers on every operating system. Only shell syntax differs: quoting, line continuation, and the `curl` executable name on Windows.\n\n## Bash-compatible Shells\n\nUse this template on macOS, Linux, WSL, and Git Bash:\n\n```bash\ncurl -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=computing' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\nDebian/Ubuntu, CentOS/RHEL, and ARM64 Linux use the same syntax. If `curl` is missing, install it with the system package manager first.\n\n## Key Differences\n\n| Part | macOS / Linux / WSL / Git Bash | Windows |\n| --- | --- | --- |\n| Shell | Bash-compatible shell | `powershell -NoProfile -Command` |\n| Curl executable | `curl` | `curl.exe` |\n| Line continuation | `\\` | PowerShell backtick inside the command string |\n\n## Windows\n\nUse this one-line PowerShell invocation for AgentExplorer API calls on Windows:\n\n```powershell\npowershell -NoProfile -Command \"curl.exe -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' `\n  --data-urlencode 'categoryCode=computing' `\n  --data-urlencode 'maxResults=20' `\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' `\n  -H 'x-acs-version: 2026-03-17'\"\n```\n\n## Translation Rules\n\n- Keep the same AgentExplorer endpoint and query parameters on every shell.\n- Keep the same required headers: `User-Agent` and `x-acs-version`.\n- Keep `--connect-timeout 10 --max-time 30` on AgentExplorer HTTP calls.\n- On Windows, use `curl.exe`, not `curl`.\n\nFile v0.0.10:references/npx-skills-agents.md\n\n# Supported `--agent` Values for `npx skills add`\n\n| Value | Agent Client |\n|---|---|\n| `augment` | Augment |\n| `bob` | Bob |\n| `claude-code` | Claude Code |\n| `openclaw` | OpenClaw |\n| `codebuddy` | CodeBuddy |\n| `command-code` | Command Code |\n| `continue` | Continue |\n| `cortex` | Cortex |\n| `crush` | Crush |\n| `droid` | Droid |\n| `goose` | Goose |\n| `junie` | Junie |\n| `iflow-cli` | iFlow CLI |\n| `kilo` | Kilo |\n| `kiro-cli` | Kiro CLI |\n| `kode` | Kode |\n| `mcpjam` | MCPJam |\n| `mistral-vibe` | Mistral Vibe |\n| `mux` | Mux |\n| `openhands` | OpenHands |\n| `pi` | Pi |\n| `qoder` | Qoder |\n| `qwen-code` | Qwen Code |\n| `roo` | Roo |\n| `trae` | Trae |\n| `trae-cn` | Trae CN |\n| `windsurf` | Windsurf |\n| `zencoder` | Zencoder |\n| `neovate` | Neovate |\n| `pochi` | Pochi |\n| `adal` | Adal |\n\nFile v0.0.10:references/search-examples.md\n\n# Search Examples\n\nExamples moved from `SKILL.md` to keep the main skill instructions focused.\n\nAll examples use AgentExplorer HTTP API directly through `curl`.\n\n## Common Use Cases & Examples\n\n### Example 1: Simple Single-Capability Request\n\nUser: \"Find skills for diagnosing ECS instance connectivity and performance issues.\"\n\n| Requirement | Search Phrase |\n| ----------- | ------------- |\n| Diagnose ECS instance connectivity and performance | ECS instance diagnosis connectivity CPU disk |\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=ECS instance diagnosis connectivity CPU disk' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n\n# Display results table, then get details for the best candidate if needed\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills/<selected-skill-name>' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n### Example 2: Category Listing Request\n\nUse category listing when the user asks to list all Skills under a category. After listing all category results, review the enumerated skills and highlight likely matches for the user's subtask. Do not install when the user asks to list only.\n\nUser: \"List all database Skills and point out which ones may fit RDS daily operations.\"\n\n```bash\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/categories' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n\n# If nextToken is returned, fetch the next page\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'maxResults=20' \\\n  --data-urlencode 'nextToken=<next-token-from-previous-response>' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n### Example 3: Natural-Language Intent Search\n\nUser: \"把本地文件同步到 OSS\"\n\n| Requirement | Search Phrase |\n| ----------- | ------------- |\n| Sync local files to OSS | 把本地文件同步到 OSS |\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=把本地文件同步到 OSS' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n### Example 4: Refine Weak Results\n\nIf the first search only matches surface wording, rewrite the search phrase toward the underlying capability before declaring a gap.\n\n| Requirement | Weak Search Phrase | Capability-Oriented Search Phrase |\n| ----------- | ------------------ | --------------------------------- |\n| Query internal standards before generating content | internal standards policy names | knowledge base retrieval document Q&A content citation |\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=knowledge base retrieval document Q&A content citation' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n### Example 5: Compound Request With Support Needs\n\nFor compound requests, create one searchable intent unit for each meaningful requirement or support need, then search each unit independently.\n\nUser: \"Generate an output from a source document, consult internal standards first, and handle setup or runtime blockers if needed.\"\n\n| Requirement | Search Phrase |\n| ----------- | ------------- |\n| Generate structured output from source material | document parsing content generation structured output |\n| Query internal standards before generation | knowledge base retrieval document Q&A content citation |\n| Handle setup or runtime blockers | runtime dependency installation environment troubleshooting |\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=document parsing content generation structured output' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=knowledge base retrieval document Q&A content citation' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=runtime dependency installation environment troubleshooting' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\nBefore installation, present the final de-duplicated install plan:\n\n```text\nFinal global Skills to install:\n\n| Skill Name | Solves |\n| ---------- | ------ |\n| <content-generation-skill> | Generates the requested output |\n| <knowledge-retrieval-skill> | Retrieves and cites internal standards |\n| <environment-guidance-skill> | Handles setup or runtime blockers |\n```\n\nFile v0.0.10:references/verification-method.md\n\n# Verification Methods\n\nThis document provides verification steps for each workflow in the `alibabacloud-find-skills` skill.\n\nDiscovery workflows use `curl` against AgentExplorer HTTP API.\n\n## Overview\n\nAfter executing each workflow, verify success by checking:\n\n1. `curl` exits with code `0`\n2. Response is valid JSON\n3. Response contains the expected field: `data`, `content`, or `requestId`\n4. Data content is valid and relevant\n5. Errors are handled without switching to Aliyun CLI\n\n## Workflow 1: Search Skills By Keyword\n\n### Success Criteria\n\nThe request succeeds:\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=ECS' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\necho \"Exit code: $?\"\n```\n\nExpected response fields:\n\n- `data`: array of skill objects\n- `totalCount`: number\n- `requestId`: string\n- `maxResults`: number\n\nEach skill should have:\n\n- `skillName`: non-empty string\n- `displayName`: non-empty string\n- `description`: non-empty string\n- `categoryName`: non-empty string\n- `installCount`: non-negative integer\n- `likeCount`: non-negative integer\n\n### Minimal Verification Script\n\n```bash\n#!/bin/bash\nKEYWORD=\"ECS\"\n\nRESULT=$(curl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode \"keyword=$KEYWORD\" \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=5' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17')\n\nif [ $? -ne 0 ]; then\n  echo \"search request failed\"\n  exit 1\nfi\n\necho \"$RESULT\" | grep -q '\"data\"' || { echo \"missing data\"; exit 1; }\necho \"$RESULT\" | grep -q '\"skillName\"' && echo \"skills found\" || echo \"no skills found\"\n```\n\n## Workflow 2: Browse Skills By Category\n\n### Success Criteria\n\nList categories succeeds:\n\n```bash\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/categories' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\nExpected category fields:\n\n- `data`: array\n- `code`: category code\n- `name`: category display name\n- `children`: child category array\n\nSearch by category succeeds:\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\nSearch results should contain `categoryCode` matching the requested top-level category.\n\n## Workflow 3: Get Skill Details\n\n### Success Criteria\n\nThe request succeeds with a valid skill name:\n\n```bash\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills/alibabacloud-cli-guidance' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\nExpected response fields:\n\n- `requestId`: string\n- `content`: non-empty markdown string\n\nThe `content` value should include skill frontmatter with `name:` and `description:`.\n\n## Workflow 4: Combined Search\n\n### Success Criteria\n\nCombined keyword and category search succeeds:\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=backup' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=10' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\nResults should be relevant to both the keyword and category.\n\n## Workflow 5: Paginated Category Listing\n\n### Success Criteria\n\nFirst page returns `nextToken` when more results exist:\n\n```bash\nPAGE1=$(curl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'maxResults=2' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17')\n\necho \"$PAGE1\" | grep -q '\"nextToken\"'\n```\n\nSecond page uses the returned token exactly:\n\n```bash\nNEXT_TOKEN=\"<next-token-from-previous-response>\"\n\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'maxResults=2' \\\n  --data-urlencode \"nextToken=$NEXT_TOKEN\" \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\nDo not invent or edit pagination tokens.\n\n## Workflow 6: Install A Skill\n\nInstallation is separate from AgentExplorer discovery.\n\n```bash\nnpx skills add aliyun/alibabacloud-aiops-skills \\\n  --skill <skill-name> \\\n  --full-depth \\\n  --agent qwen-code \\\n  -g -y\n```\n\nManual checklist:\n\n- [ ] Installation command completed without errors\n- [ ] Skill appears in the target agent's skill list\n- [ ] Skill can be triggered with appropriate keywords\n- [ ] Installed Skill's own prerequisites are followed\n\n## Error Verification\n\n### Network Failure\n\nFor DNS, proxy, or TLS errors:\n\n1. Retry once\n2. Check network/proxy access to `agentexplorer.aliyuncs.com`\n3. Report the failure with the attempted endpoint and operation\n4. Do not fall back to Aliyun CLI unless the user explicitly requests it\n\n## General Verification Checklist\n\n### Request Execution\n\n- [ ] Uses `curl`, not `aliyun`\n- [ ] Uses `https://agentexplorer.aliyuncs.com`\n- [ ] Includes `User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills`\n- [ ] Includes `x-acs-version: 2026-03-17`\n- [ ] Uses `--data-urlencode` for query values with spaces, Chinese text, or tokens\n\n### Response Format\n\n- [ ] Search response has `data`\n- [ ] Category response has `data`\n- [ ] Detail response has `content`\n- [ ] Error response is summarized clearly\n\n### User Presentation\n\n- [ ] Results are shown as a table or concise list\n- [ ] `skillName`, display name, category, description, and install count are included when available\n- [ ] The final install plan is de-duplicated\n- [ ] Installation is performed only when the user asked for it\n\nFile v0.0.10:skill-card.md\n\n## Description:\n\nHelps agents search, browse, inspect, and when requested install Alibaba Cloud agent skills from the AgentExplorer catalog.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[sdk-team](https://clawhub.ai/user/sdk-team)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and agent users use this skill to discover Alibaba Cloud skills by intent, keyword, or category, inspect matching skill details, and receive installation guidance only when they explicitly request installation.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Search queries may expose secrets, customer names, access keys, incident details, or internal identifiers.\n\nMitigation: Sanitize search phrases before use and avoid placing sensitive or private identifiers in AgentExplorer queries.\n\nRisk: The documented installation path can add agent skills globally through unpinned npx commands while skipping confirmation.\n\nMitigation: Review selected skills before installation, prefer pinned and project-local installs, and use global non-interactive installation only when a persistent global agent change is intended.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/sdk-team/skills/alibabacloud-find-skills)\n- [AgentExplorer API Base URL](https://agentexplorer.aliyuncs.com)\n- [AgentExplorer HTTP API Reference](references/agentexplorer-api.md)\n- [Search Examples](references/search-examples.md)\n- [Category Examples](references/category-examples.md)\n- [Verification Methods](references/verification-method.md)\n- [Curl Shell Compatibility Guide](references/curl-shell-compatibility.md)\n- [Supported Agent Values for npx skills add](references/npx-skills-agents.md)\n- [Acceptance Criteria](references/acceptance-criteria.md)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Guidance]\n\n**Output Format:** [Markdown with result summaries, tables, and inline shell commands]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include AgentExplorer API request shapes, selected skill details, and installation commands when installation is requested.]\n\n## Skill Version(s):\n\n0.0.10 (source: server release metadata and changelog)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v0.0.9: 10 files, 21127 bytes\n\nFiles: references/acceptance-criteria.md (8127b), references/agentexplorer-api.md (6974b), references/category-examples.md (4332b), references/curl-shell-compatibility.md (2324b), references/npx-skills-agents.md (798b), references/search-examples.md (6355b), references/verification-method.md (6866b), skill-card.md (2560b), SKILL.md (24661b), _meta.json (143b)\n\nFile v0.0.9:SKILL.md\n\n---\nname: alibabacloud-find-skills\ndescription: >\n  Use this skill when users want to search, discover, browse, or find Alibaba Cloud (阿里云) agent skills.\n  Triggers include: \"find a skill for X\", \"search alicloud skills\", \"阿里云有什么 skill\",\"阿里云\",\n  \"搜索阿里云技能\", \"有没有管理 ECS/RDS/OSS 的 skill\", \"阿里云 skills 有哪些类目\",\n  \"帮我找一个 skill\", \"browse alicloud skills\", \"list alicloud skill categories\",\n  \"is there an alicloud skill that can...\", \"what alicloud skills are available\", \"XX Skill 的内容是什么\", \"我想了解阿里云 XX Skill 具体做什么\",\"帮我安装阿里云 Skill\",\"使用阿里云相关的skill\",\n  \"阿里云 agent skill 市场\", \"搜一下阿里云的 skill\", \"建一个数据分析项目有没有相关 skill\".\n---\n\n> [!IMPORTANT]\n> **For any Alibaba Cloud query or management task:**\n> 1. **Search** — use this skill (`alibabacloud-find-skills`) to find the relevant Skill(s).\n> 2. **Install** — install the selected Skill(s) only when the user asks to install or use them to complete the task.\n> 3. **Execute** — follow the installed Skill(s)' instructions to fulfill the request.\n\n# Alibaba Cloud Agent Skills Search & Discovery\n\nThis skill helps users search, discover, and install Alibaba Cloud official Agent Skills from the AgentExplorer catalog.\n\n## Scenario Description\n\nThis skill enables users to:\n\n1. **Search Skills** — Find Alibaba Cloud Agent Skills by intent phrase, keyword, category listing, or combined semantic search\n2. **Browse Categories** — Explore available skill categories and subcategories\n3. **View Skill Details** — Get detailed information about specific skills\n4. **Install Skills** — Guide users through skill installation when installation is requested\n\n**Architecture**: `curl` + AgentExplorer HTTP API → Skills Repository\n\nDiscovery 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.\n\n### Use Cases\n\n- \"Find a skill for managing ECS instances\"\n- \"What Alibaba Cloud skills are available for databases?\"\n- \"阿里云有哪些 OSS 相关的 skill?\"\n- \"Browse all available alicloud skills\"\n- \"Install a skill for RDS management\"\n\n## AgentExplorer HTTP API\n\n**Base URL**: `https://agentexplorer.aliyuncs.com`\n\nEvery AgentExplorer HTTP request must include these headers.\n\n```bash\n# Bash-compatible header snippet for macOS, Linux, WSL, and Git Bash.\n# On Windows, use the PowerShell command shape below instead.\n-H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n-H 'x-acs-version: 2026-03-17' \\\n-H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n`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`.\n\nEvery AgentExplorer HTTP `curl` / `curl.exe` request must include `--connect-timeout 10 --max-time 30`.\n\n### Shell-compatible curl usage\n\nBefore 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.\n\n### API Shapes\n\n#### Bash-compatible Examples\n\n```bash\n# Bash-compatible examples for macOS, Linux, WSL, and Git Bash.\n# On Windows, use the PowerShell command shape below and replace endpoint/query parameters.\n\n# Search skills\ncurl -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=<user-intent-or-keyword>' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n\n# List categories\ncurl -sS --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/categories' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n\n# Get skill content\ncurl -sS --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills/<skillName>' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n#### Windows PowerShell Search Example\n\nUse this command shape on Windows and replace only query parameters as needed:\n\n```powershell\npowershell -NoProfile -Command \"curl.exe -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' --data-urlencode 'keyword=<user-intent-or-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'))\"\n```\n\n## Core Workflow\n\n### Step 1: Understand What They Need\n\nBefore searching, identify:\n\n1. **Domain** — The relevant area or Alibaba Cloud product family, e.g., ECS, RDS, OSS, SLS, PAI, testing, deployment, data analysis.\n2. **Specific task** — What the user wants to do, e.g., diagnose ECS issues, sync files to OSS, build a data analysis project, review permissions.\n3. **Skill likelihood** — Whether this is a common enough task that an existing Skill likely exists.\n4. **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.\n\nUse 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.\n\nBefore 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.\n\nThe `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.\n\nIf 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.\n\n### Step 2: Search Skills\n\nChoose 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.\n\n- **Intent search (default for task matching)**: Use the user's task or full intent phrase as `keyword`, with `searchMode=semantic`.\n- **Keyword search**: Use concise product/task keywords with `searchMode=semantic` when the intent is broad, noisy, or already names a product/capability.\n- **Category browsing**: Call `/openapi/for-agent/categories` when the user asks for available categories or when a category code must be confirmed.\n- **List skills in a category**: Use `categoryCode` only. Do not pass `keyword` or `searchMode=semantic`; this mode supports pagination.\n- **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.\n\nChoose one request shape based on the user request:\n\n```bash\n# Bash-compatible examples for macOS, Linux, WSL, and Git Bash.\n# On Windows, use the PowerShell command shape above and replace endpoint/query parameters.\n\n# Intent or keyword search\ncurl -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=<user-intent-or-keyword>' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n\n# Get all categories before listing skills in a category\ncurl -sS --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/categories' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n\n# List skills in a category\ncurl -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=<category-code>' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n\n# Fetch the next category page if nextToken is returned\ncurl -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=<category-code>' \\\n  --data-urlencode 'maxResults=20' \\\n  --data-urlencode 'nextToken=<next-token-from-previous-response>' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n\n# Combined semantic search after category selection\ncurl -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=<user-intent-or-keyword>' \\\n  --data-urlencode 'categoryCode=<category-code>' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n### Step 3: Iterate Until Found\n\nIf 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:\n\n1. Start with the user's full intent phrase when available\n2. Extract direct product/task keywords from the request\n3. Switch between Chinese and English terms (\"cloud server\" → \"ECS\", \"object storage\" → \"OSS\")\n4. Broaden or simplify keywords (drop qualifiers: \"RDS backup automation\" → \"RDS\")\n5. Use `/openapi/for-agent/categories`, select the best category, then retry with combined search\n6. Try synonyms or related terms (\"instance\" → \"ECS\", \"bucket\" → \"OSS\")\n\nDo not conclude \"no dedicated Skill exists\" until you have tried at least one capability-oriented search phrase for that intent unit.\n\nRepeat 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.\n\n### Step 4: View Skill Details (Optional)\n\nOptionally retrieve skill content to verify it matches user intent before installation. This step can be skipped if the search results already provide sufficient information.\n\n```bash\n# Bash-compatible example for macOS, Linux, WSL, and Git Bash.\n# On Windows, use the PowerShell command shape above and replace endpoint/query parameters.\n\ncurl -sS --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills/<skillName>' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n### Step 5: Install Selected Skill(s)\n\nSkip 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.\n\n```bash\n# Option A: Using npx skills add\n# By default this command is interactive (blocks for user input).\n# Recommended: use non-interactive mode to avoid blocking.\n#   --agent <client>   Agent client to install for (see references/npx-skills-agents.md)\n#   -g                 Install globally (home dir); omit for project-local install\n#   -y                 Skip confirmation (requires --agent and -g/-local to be set)\nnpx skills add aliyun/alibabacloud-aiops-skills \\\n  --skill <skill-name> \\\n  --full-depth \\\n  --agent qwen-code \\\n  -g -y\n\n# Option B: Using npx clawhub install (OpenClaw ecosystem)\nnpx clawhub install <selected-skill-name>\n```\n\nVerify each selected Skill appears in the available skills list after installation.\n\n## API Reference\n\nFor complete HTTP parameter details and search parameter rules, see [references/agentexplorer-api.md](references/agentexplorer-api.md).\n\n## Success Verification\n\nAfter each operation, verify success by checking:\n\n1. **List Categories**: Response contains `data` with category `code` and `name` fields\n2. **Search Skills**: Response contains `data` with valid skill objects\n3. **Get Skill Content**: Response contains complete skill markdown `content`\n4. **Install Selected Skill(s)**: Each selected Skill appears in the available skills list\n\nFor detailed verification steps, see [references/verification-method.md](references/verification-method.md).\n\n## Search Strategies\n\n### 1. Intent Analysis for Search\n\nBefore 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.\n\nFor each meaningful requirement, identify:\n\n- **Action**: What operation is needed, e.g., query, generate, diagnose, deploy, install, validate, transform\n- **Object**: What the operation applies to, e.g., document, knowledge base, video, script, database, CLI environment\n- **Context/source**: Where the information or resource comes from, e.g., internal docs, cloud service, local file, OSS, database, runtime environment\n- **Expected output**: What the user expects back, e.g., answer with citations, generated script, report, command guidance, installed dependency\n- **Support needs**: Whether the request also needs plugins, runtime dependencies, environment checks, or troubleshooting\n\nTreat 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.\n\nThen form one or more searchable intent phrases using:\n\n`<action> + <object/capability> + <context/source> + <expected output>`\n\nFor compound requests, create one searchable intent unit per meaningful requirement and search each unit independently. Do not assume one Skill covers the whole request unless the search result clearly states that it does.\n\nA single searchable intent unit may still require multiple complementary Skills. When one Skill covers the main action but another Skill is needed for supporting needs such as plugins, runtime setup, data access, or validation, select both and explain their roles separately.\n\n### 2. Search Text Selection\n\n- **Use intent phrases first**: Prefer the user's natural-language task or requirement, e.g., \"建一个数据分析项目\", \"把本地文件同步到 OSS\"\n- **Use product/task keywords when intent is broad or noisy**: Extract concise product and action terms, e.g., \"ECS 诊断\", \"OSS 同步\"\n- **Use product codes as fallback or refinement**: `ecs`, `rds`, `oss`, `slb`, `vpc`\n- **Use Chinese and English variants**: e.g., \"云服务器\" / \"ECS\", \"对象存储\" / \"OSS\"\n- **Use broader terms only after specific intent searches fail**: e.g., \"compute\", \"storage\", \"network\"\n\n### 3. Category Filtering\n\n- **Browse when needed**: Use `/openapi/for-agent/categories` when the user asks about categories or when the domain should narrow the search\n- **Select the best category**: Map the domain to the closest `categoryCode`, then pass it as `categoryCode`\n- **Combine with intent**: For clear tasks inside a clear domain, use the task phrase as `keyword` and the selected category as `categoryCode`\n\n### 4. Result Optimization\n\n- **Start with intent**: Begin with the user's task description, then add category filtering only when the domain is clear or initial results are too broad\n- **Keep complementary Skills together**: If one Skill handles the main task and another handles required setup, access, validation, or troubleshooting, include both instead of choosing only the top-ranked main Skill\n- **Check install counts**: Popular skills usually have higher install counts\n- **Read descriptions**: Match skill description to your specific use case\n\n### 5. When No Results Found\n\n```bash\n# Bash-compatible examples for macOS, Linux, WSL, and Git Bash.\n# On Windows, use the PowerShell command shape above and replace endpoint/query parameters.\n\n# Strategy 1: Try the full user intent\n# Instead of just \"OSS\", try \"把本地文件同步到 OSS\"\n\n# Strategy 2: Extract product/task keywords\n# Instead of \"云服务器故障排查\", try \"ECS 诊断\"\n\n# Strategy 3: Try Chinese and English variants\n# Instead of \"云服务器\" try \"ECS\" or \"instance\"\n\n# Strategy 4: Use broader terms\n# Instead of \"RDS backup automation\" try just \"RDS\" or \"database\"\n\n# Strategy 5: Browse or filter by category\ncurl -sS --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/categories' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n\ncurl -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=ECS 实例管理' \\\n  --data-urlencode 'categoryCode=<selected-category-code>' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n### 6. Display Results to Users\n\nWhen presenting search results, format as table:\n\n```\nFound N skills:\n\n| Skill Name | Display Name | Description | Category | Install Count |\n|------------|--------------|-------------|----------|---------------|\n| alibabacloud-ecs-batch | ECS Batch Operations | Batch manage ECS instances | Computing > ECS | 245 |\n| ... | ... | ... | ... | ... |\n```\n\nInclude:\n\n- **skillName**: For installation and detailed queries\n- **displayName**: User-friendly name\n- **description**: Brief overview\n- **categoryName** + **subCategoryName**: Classification\n- **installCount**: Popularity indicator\n\n## Cleanup\n\nThis skill does not create any resources. No cleanup is required.\n\n## Best Practices\n\n1. **Choose the right search mode** — Use semantic intent or keyword search for task matching; use category listing without `searchMode=semantic` when the user asks to list all Skills in a category\n2. **Search by intent units** — Split compound requests into meaningful capability and support needs, then search each unit independently\n3. **Refine weak results** — If results only match surface wording or miss an intent unit, rewrite the phrase toward the underlying capability and retry before declaring a gap\n4. **Keep complementary Skills together** — Select multiple Skills when one covers the main task and another covers required setup, access, validation, troubleshooting, or runtime support\n5. **Display results clearly** — Use tables with `skillName`, display name, category, description, and install count\n6. **Install only when requested** — Do not install for list-only, browse-only, or compare-only requests\n7. **Verify before installation** — Use the skill content endpoint when search results are not sufficient to confirm fit\n8. **Verify after installation** — Confirm every selected Skill is available after installation\n\n## Common Use Cases & Examples\n\nFor examples, see [references/search-examples.md](references/search-examples.md).\n\n## Reference Documentation\n\n| Reference                                                              | Description                                  |\n| ---------------------------------------------------------------------- | -------------------------------------------- |\n| [references/agentexplorer-api.md](references/agentexplorer-api.md)     | Complete AgentExplorer HTTP API reference    |\n| [references/verification-method.md](references/verification-method.md) | Success verification steps for each workflow |\n| [references/acceptance-criteria.md](references/acceptance-criteria.md) | Testing acceptance criteria and patterns     |\n| [references/category-examples.md](references/category-examples.md)     | Common category codes and examples           |\n| [references/search-examples.md](references/search-examples.md)         | Common search workflow examples              |\n| [references/curl-shell-compatibility.md](references/curl-shell-compatibility.md) | Shell-specific curl command templates        |\n| [references/npx-skills-agents.md](references/npx-skills-agents.md)     | Supported `--agent` values for `npx skills add` |\n\n## Troubleshooting\n\n### Error: `MissingDate`\n\n**Cause**: The request is missing `x-acs-date`.\n\n**Solution**: Add the UTC timestamp header:\n\n```bash\n# Bash-compatible header snippet for macOS, Linux, WSL, and Git Bash.\n# On Windows, use the PowerShell command shape above instead.\n-H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n### Error: `InvalidTimeStamp.Expired` or `Invalidx-acs-date`\n\n**Cause**: `x-acs-date` is stale, local time, malformed, copied from an earlier request, or hardcoded as a literal timestamp.\n\n**Solution**: Regenerate current UTC time at request execution time and retry the same request. On Windows PowerShell, use the exact timestamp expression from [references/curl-shell-compatibility.md](references/curl-shell-compatibility.md); do not switch to Unix timestamps, invent a different PowerShell date expression, or reuse an old header value.\n\nIf the failed Windows command contains `$(date -u ...)`, it used the Bash timestamp expression. Retry with the Windows `powershell -NoProfile -Command` template above.\n\nIf PowerShell reports `Invoke-WebRequest` or parameter-binding errors, the command used the `curl` alias. Retry with `curl.exe`.\n\n### Error: DNS, connection, or TLS failure\n\n**Cause**: Network access to `agentexplorer.aliyuncs.com` failed.\n\n**Solutions**:\n\n1. Retry once; transient network failures are possible.\n2. Check proxy or network policy if running in a restricted agent sandbox.\n3. Do not switch to Aliyun CLI as a workaround unless the user explicitly asks.\n\n### No Results Returned\n\n**Cause**: Search mode, search phrase, or category code does not match the user's request.\n\n**Solutions**:\n\n1. For semantic intent search, rewrite the phrase toward the underlying capability instead of repeating private/internal wording\n2. Try Chinese and English variants, product codes, and concise product/task keywords\n3. For weak semantic results, retry with a selected `categoryCode` and `searchMode=semantic`\n4. For category listing, verify the `categoryCode` with `/openapi/for-agent/categories`, omit `keyword` and `searchMode`, and use `nextToken` when pagination is returned\n5. Declare a gap only after each searchable intent unit has been retried with at least one capability-oriented phrase\n\n## Notes\n\n- **Read-only operations**: This skill only performs queries, no resources are created\n- **No CLI prerequisite**: Discovery uses `curl`; downstream selected Skills may have their own CLI or permission requirements\n- **Multi-language support**: Keywords support both English and Chinese\n- **Regular updates**: Skills catalog is regularly updated with new skills\n- **Community skills**: Some skills may be community-contributed, check descriptions carefully\n\nFile v0.0.9:_meta.json\n\n{\n  \"ownerId\": \"kn74p5w8ywv6prh40g0s82gmqh83nw54\",\n  \"slug\": \"alibabacloud-find-skills\",\n  \"version\": \"0.0.9\",\n  \"publishedAt\": 1780998661630\n}\n\nFile v0.0.9:references/acceptance-criteria.md\n\n# Acceptance Criteria: alibabacloud-find-skills\n\n**Skill Name**: `alibabacloud-find-skills`\n**Purpose**: Validate correct AgentExplorer HTTP API usage and skill-discovery behavior.\n\n## Discovery Prerequisites\n\n### Correct\n\nThe discovery workflow uses `curl` directly:\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=ECS' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n### Incorrect\n\n```bash\naliyun version\naliyun plugin search agentexplorer\naliyun plugin install --names aliyun-cli-agentexplorer\naliyun plugin update --name aliyun-cli-agentexplorer\naliyun agentexplorer search-skills --keyword \"ECS\"\naliyun configure list\n```\n\n**Why**: Finding, browsing, and inspecting Skills uses direct HTTP requests and no longer requires Aliyun CLI or the AgentExplorer CLI plugin.\n\n## HTTP API Patterns\n\n### 1. Search Skills\n\n#### Correct\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=RDS backup automation' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n#### Incorrect\n\n```bash\n# Missing -G: query params are not appended as intended\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=RDS backup automation'\n\n# Wrong parameter names from CLI mode\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'search-mode=semantic' \\\n  --data-urlencode 'max-results=20'\n\n# Wrong endpoint path\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/search-skills'\n```\n\n**Why**: HTTP query parameters use API names such as `searchMode`, `maxResults`, `categoryCode`, and `nextToken`.\n\n### 2. List Categories\n\n#### Correct\n\n```bash\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/categories' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n#### Incorrect\n\n```bash\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/category'\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/list-categories'\n```\n\n### 3. Get Skill Content\n\n#### Correct\n\n```bash\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills/alibabacloud-cli-guidance' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n#### Incorrect\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'skillName=alibabacloud-cli-guidance'\n\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skill/alibabacloud-cli-guidance'\n```\n\n**Why**: Skill content uses a path parameter: `/openapi/for-agent/skills/{skillName}`.\n\n## Header Requirements\n\n### Correct\n\nEvery discovery API call includes all three headers:\n\n```bash\n-H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n-H 'x-acs-version: 2026-03-17' \\\n-H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n### Incorrect\n\n```bash\n# Missing date header\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=ECS' \\\n  -H 'x-acs-version: 2026-03-17'\n\n# Wrong user agent\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=ECS' \\\n  -H 'User-Agent: MyAgent'\n\n# Wrong header shape for this workflow\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  -H 'x-acs-api-version: 2026-03-17'\n```\n\n**Why**: `x-acs-date` is mandatory. The skill user-agent is required for attribution. The API version header must be `x-acs-version`.\n\n## Search Parameter Rules\n\n### Correct\n\n```bash\n# Intent search\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=把本地文件同步到 OSS' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n\n# Category listing\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n\n# Combined semantic search\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=backup' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n### Incorrect\n\n```bash\n# Category listing should not use semantic mode\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'searchMode=semantic'\n\n# Multi-word values are not URL-encoded\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills?keyword=RDS backup automation'\n```\n\n## Pagination Rules\n\n### Correct\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'maxResults=20' \\\n  --data-urlencode 'nextToken=<next-token-from-previous-response>' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n### Incorrect\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'next-token=abc'\n\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'nextToken=page2'\n```\n\n**Why**: Use the API field name `nextToken`, and pass the returned token exactly.\n\n## Result Handling\n\n### Correct\n\nPresent users a concise table:\n\n```markdown\n| Skill Name | Display Name | Category | Install Count | Why it fits |\n| --- | --- | --- | ---: | --- |\n| alibabacloud-ecs-batch | ECS Batch Ops | 计算 > ECS | 245 | Handles batch ECS operations |\n```\n\n### Incorrect\n\n```bash\n# Dumping raw JSON without summarizing\necho \"$RESULT\"\n```\n\n## Installation Rules\n\n### Correct\n\nOnly install when the user asks to install or use a selected Skill:\n\n```bash\nnpx skills add aliyun/alibabacloud-aiops-skills \\\n  --skill <skill-name> \\\n  --full-depth \\\n  --agent qwen-code \\\n  -g -y\n```\n\n### Incorrect\n\n```bash\n# Installing during browse-only/search-only requests\nnpx skills add aliyun/alibabacloud-aiops-skills --skill <skill-name>\n```\n\n## Failure Handling\n\n- On `MissingDate`, add `x-acs-date`.\n- On network failure, retry once and report endpoint/network context.\n- On weak or empty results, rewrite the search phrase toward the underlying capability.\n- Do not tell the user to install or configure Aliyun CLI for this discovery workflow.\n\n## Final Checklist\n\n- [ ] Uses `curl`, not `aliyun`, for discovery\n- [ ] Uses `https://agentexplorer.aliyuncs.com/openapi/for-agent/skills` for search/listing\n- [ ] Uses `https://agentexplorer.aliyuncs.com/openapi/for-agent/categories` for categories\n- [ ] Uses `/openapi/for-agent/skills/{skillName}` for details\n- [ ] Includes `User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills`\n- [ ] Includes `x-acs-version: 2026-03-17`\n- [ ] Includes `x-acs-date`\n- [ ] Uses `--data-urlencode` for query parameters\n- [ ] Splits compound requests into searchable intent units\n- [ ] Installs selected Skills only when requested\n\nFile v0.0.9:references/agentexplorer-api.md\n\n# AgentExplorer HTTP API Reference\n\nComplete reference for HTTP requests used by the `alibabacloud-find-skills` skill.\n\nDiscovery uses `curl` directly. Do not install Aliyun CLI or the `agentexplorer` CLI plugin for this skill's search, browse, or detail workflows.\n\n## Common Request Headers\n\nEvery AgentExplorer request must include:\n\n```bash\n-H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n-H 'x-acs-version: 2026-03-17' \\\n-H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n`x-acs-date` is mandatory and must be current UTC time.\n\nFor Windows PowerShell, Command Prompt, macOS, Linux, WSL, and Git Bash curl templates, see [curl-shell-compatibility.md](curl-shell-compatibility.md).\n\n## API Summary\n\n| API | Purpose | Required values |\n| --- | --- | --- |\n| `GET /openapi/for-agent/skills` | Search or list skills | Common headers; query params depend on mode |\n| `GET /openapi/for-agent/categories` | List skill categories | Common headers |\n| `GET /openapi/for-agent/skills/{skillName}` | Get skill details | Common headers; path `skillName` |\n\nBase URL:\n\n```text\nhttps://agentexplorer.aliyuncs.com\n```\n\n## 1. Search Or List Skills\n\n**Endpoint**:\n\n```text\nGET https://agentexplorer.aliyuncs.com/openapi/for-agent/skills\n```\n\n**Query parameters**:\n\n| Parameter | Required | Description |\n| --- | --- | --- |\n| `keyword` | No | Search keyword or full intent phrase |\n| `categoryCode` | No | Top-level category code, dot-form child category, or comma-separated category list |\n| `searchMode` | Conditional | Use `semantic` for intent/keyword/combined search; omit for pure category listing |\n| `maxResults` | No | Maximum results per page, default `20`, max `100` |\n| `nextToken` | No | Pagination token returned by the previous response |\n| `skip` | No | Number of records to skip; prefer `nextToken` for pagination |\n\n### Semantic Intent Or Keyword Search\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=<keyword-or-intent>' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n### List Skills In A Category\n\nUse when the user asks to list or browse all Skills under a category. Do not pass `keyword` or `searchMode=semantic`.\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=<category-code>' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\nFetch the next page only when `nextToken` is returned:\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=<category-code>' \\\n  --data-urlencode 'maxResults=20' \\\n  --data-urlencode 'nextToken=<next-token-from-previous-response>' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n### Combined Semantic Search\n\nUse only after category selection when the user asks for best matches inside a category.\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=<keyword-or-intent>' \\\n  --data-urlencode 'categoryCode=<category-code>' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n**Response shape**:\n\n```json\n{\n  \"data\": [\n    {\n      \"skillName\": \"alibabacloud-ecs-batch-command\",\n      \"displayName\": \"ECS 批量命令执行\",\n      \"description\": \"批量在多台 ECS 实例上执行命令\",\n      \"categoryCode\": \"computing\",\n      \"categoryName\": \"计算\",\n      \"subCategoryCode\": \"ecs\",\n      \"subCategoryName\": \"云服务器 ECS\",\n      \"installCount\": 245,\n      \"likeCount\": 18\n    }\n  ],\n  \"totalCount\": 100,\n  \"nextToken\": \"eyJwYWdlIjoyfQ==\",\n  \"maxResults\": 20,\n  \"requestId\": \"...\"\n}\n```\n\n## 2. List Categories\n\n**Endpoint**:\n\n```text\nGET https://agentexplorer.aliyuncs.com/openapi/for-agent/categories\n```\n\n**Example**:\n\n```bash\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/categories' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n**Response shape**:\n\n```json\n{\n  \"data\": [\n    {\n      \"code\": \"computing\",\n      \"name\": \"计算\",\n      \"children\": [\n        {\n          \"code\": \"ecs\",\n          \"name\": \"云服务器 ECS\"\n        }\n      ]\n    }\n  ],\n  \"requestId\": \"...\"\n}\n```\n\n## 3. Get Skill Content\n\n**Endpoint**:\n\n```text\nGET https://agentexplorer.aliyuncs.com/openapi/for-agent/skills/{skillName}\n```\n\n**Example**:\n\n```bash\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills/<skillName>' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n**Response shape**:\n\n```json\n{\n  \"requestId\": \"...\",\n  \"content\": \"---\\nname: alibabacloud-ecs-batch-command\\n...\"\n}\n```\n\n## Category Code Rules\n\n- Top-level category: use the category code directly, e.g. `computing`\n- Child category: use dot notation only when the API supports it for the target category, e.g. `computing.ecs`\n- Multiple categories: comma-separate category codes, e.g. `computing,database`\n- If a bare child category such as `ecs` does not filter as expected, use it as `keyword` or confirm the current category list first\n\n## Search Usage Patterns\n\nUse the same semantic-search shape for both keywords and full intent phrases:\n\n```bash\n# Keyword search\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=ECS' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n\n# Intent search\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=把本地文件同步到 OSS' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n## Notes\n\n- Do not use Aliyun CLI flags such as `--endpoint`, `--region`, `--user-agent`, or `--cli-query` in the HTTP workflow.\n- Use `jq` only if it is already available; otherwise inspect the JSON response directly and summarize the relevant fields.\n\nFile v0.0.9:references/category-examples.md\n\n# Category Examples\n\nThis reference provides common category codes and examples for navigating the Alibaba Cloud Agent Skills catalog.\n\nFor the complete, current category list, call:\n\n```bash\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/categories' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n## Category Code Format\n\n- Top-level category: use the category code directly, e.g. `computing`\n- Child category: when supported, use dot notation, e.g. `computing.ecs`\n- Multiple categories: comma-separate codes, e.g. `computing,database`\n- If child code filtering is uncertain, confirm with `/openapi/for-agent/categories`, then use either dot notation or a semantic `keyword`\n\n## Common Categories\n\n| Code | Name | Typical Domains |\n| --- | --- | --- |\n| `computing` | 计算 | ECS, ECI, EHPC, ComputeNest, Alibaba Cloud Linux |\n| `aiml` | 人工智能与机器学习 | PAI, Bailian, OpenSearch, AgentBay |\n| `developertools` | 开发工具 | CLI guidance, developer workflows |\n| `storage` | 存储 | OSS, SLS, Tablestore, PDS, HBR |\n| `migrationom` | 迁移与运维管理 | OOS, Terraform import, resource management |\n| `netcdn` | 网络与CDN | NIS, SAG, DCDN |\n| `middleware` | 中间件 | CMS, API Gateway, PTS, STAROps |\n| `doweb` | 域名与网站 | Domain, ICP filing, website building |\n| `security` | 安全 | SAS, WAF, KMS, CFW, DDoS |\n| `database` | 数据库 | RDS, PolarDB, Tair, MongoDB, DTS, DMS |\n| `analyticscomputing` | 大数据计算 | DataWorks, MaxCompute, Flink, Hologres, Elasticsearch, Milvus |\n| `entcmc` | 企业服务与云通信 | SMS, voice, Chat App |\n| `mediaservices` | 媒体服务 | Live, MTS, ICE |\n| `others` | 其他 | General solutions |\n| `playbooks` | 场景化实战 | Troubleshooting and optimization playbooks |\n| `solutions` | 阿里云级跨产品类目解决方案 | Cross-product solutions |\n\n## Example Searches\n\n### Browse A Top-Level Category\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n### Search Within A Category\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=RDS backup automation' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n### Try A Child Category Or Product Keyword\n\n```bash\n# Child category form, when supported\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=computing.ecs' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n\n# Product keyword fallback\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=ECS instance management' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n## Domain Mapping Hints\n\n| User Domain | Start With | Refinement Keywords |\n| --- | --- | --- |\n| ECS / servers | `computing` | ECS, instance, diagnosis, command, patch |\n| RDS / PolarDB / Redis | `database` | RDS, PolarDB, Tair, SQL, backup, performance |\n| OSS / files / logs | `storage` | OSS, SLS, upload, sync, index, media |\n| Data projects | `analyticscomputing` | DataWorks, MaxCompute, Flink, Hologres |\n| AI / RAG / knowledge base | `aiml` | Bailian, knowledge base, RAG, PAI |\n| Security | `security` | SAS, WAF, KMS, vulnerability, bot |\n| Network troubleshooting | `netcdn` | NIS, reachability, SAG, DCDN |\n| Deployment / operations | `migrationom` | OOS, Terraform, patch, import, resource |\n\nFile v0.0.9:references/curl-shell-compatibility.md\n\n# Curl Shell Compatibility Guide\n\nAgentExplorer HTTP APIs use the same URL, query parameters, and headers on every operating system. Only shell syntax differs: quoting, line continuation, and UTC timestamp generation.\n\n## Bash-compatible Shells\n\nUse this template on macOS, Linux, WSL, and Git Bash:\n\n```bash\ncurl -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=computing' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\nDebian/Ubuntu, CentOS/RHEL, and ARM64 Linux use the same syntax. If `curl` is missing, install it with the system package manager first.\n\n## Key Differences\n\n| Part | macOS / Linux / WSL / Git Bash | Windows |\n| --- | --- | --- |\n| Shell | Bash-compatible shell | `powershell -NoProfile -Command` |\n| Curl executable | `curl` | `curl.exe` |\n| UTC timestamp | `$(date -u +%Y-%m-%dT%H:%M:%SZ)` | `[DateTimeOffset]::UtcNow.ToString('yyyy-MM-ddTHH:mm:ssZ')` |\n| Line continuation | `\\` | PowerShell backtick inside the command string |\n\n## Windows\n\nUse this one-line PowerShell invocation for AgentExplorer API calls on Windows:\n\n```powershell\npowershell -NoProfile -Command \"curl.exe -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' `\n  --data-urlencode 'categoryCode=computing' `\n  --data-urlencode 'maxResults=20' `\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' `\n  -H 'x-acs-version: 2026-03-17' `\n  -H ('x-acs-date: ' + [DateTimeOffset]::UtcNow.ToString('yyyy-MM-ddTHH:mm:ssZ'))\"\n```\n\nKeep the `x-acs-date` header as the expression above. Do not replace it with a literal timestamp such as `YYYY-MM-DDT00:00:00Z`.\n\n## Translation Rules\n\n- Keep the same AgentExplorer endpoint and query parameters on every shell.\n- Keep the same required headers: `User-Agent`, `x-acs-version`, and `x-acs-date`.\n- Keep `--connect-timeout 10 --max-time 30` on AgentExplorer HTTP calls.\n- On Windows, use `curl.exe`, not `curl`.\n- Generate the Windows `x-acs-date` header inline with `[DateTimeOffset]::UtcNow`; do not precompute it in a separate `$date` variable or hardcode it as a clock value.\n\nFile v0.0.9:references/npx-skills-agents.md\n\n# Supported `--agent` Values for `npx skills add`\n\n| Value | Agent Client |\n|---|---|\n| `augment` | Augment |\n| `bob` | Bob |\n| `claude-code` | Claude Code |\n| `openclaw` | OpenClaw |\n| `codebuddy` | CodeBuddy |\n| `command-code` | Command Code |\n| `continue` | Continue |\n| `cortex` | Cortex |\n| `crush` | Crush |\n| `droid` | Droid |\n| `goose` | Goose |\n| `junie` | Junie |\n| `iflow-cli` | iFlow CLI |\n| `kilo` | Kilo |\n| `kiro-cli` | Kiro CLI |\n| `kode` | Kode |\n| `mcpjam` | MCPJam |\n| `mistral-vibe` | Mistral Vibe |\n| `mux` | Mux |\n| `openhands` | OpenHands |\n| `pi` | Pi |\n| `qoder` | Qoder |\n| `qwen-code` | Qwen Code |\n| `roo` | Roo |\n| `trae` | Trae |\n| `trae-cn` | Trae CN |\n| `windsurf` | Windsurf |\n| `zencoder` | Zencoder |\n| `neovate` | Neovate |\n| `pochi` | Pochi |\n| `adal` | Adal |\n\nFile v0.0.9:references/search-examples.md\n\n# Search Examples\n\nExamples moved from `SKILL.md` to keep the main skill instructions focused.\n\nAll examples use AgentExplorer HTTP API directly through `curl`.\n\n## Common Use Cases & Examples\n\n### Example 1: Simple Single-Capability Request\n\nUser: \"Find skills for diagnosing ECS instance connectivity and performance issues.\"\n\n| Requirement | Search Phrase |\n| ----------- | ------------- |\n| Diagnose ECS instance connectivity and performance | ECS instance diagnosis connectivity CPU disk |\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=ECS instance diagnosis connectivity CPU disk' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n\n# Display results table, then get details for the best candidate if needed\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills/<selected-skill-name>' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n### Example 2: Category Listing Request\n\nUse category listing when the user asks to list all Skills under a category. After listing all category results, review the enumerated skills and highlight likely matches for the user's subtask. Do not install when the user asks to list only.\n\nUser: \"List all database Skills and point out which ones may fit RDS daily operations.\"\n\n```bash\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/categories' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n\n# If nextToken is returned, fetch the next page\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'maxResults=20' \\\n  --data-urlencode 'nextToken=<next-token-from-previous-response>' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n### Example 3: Natural-Language Intent Search\n\nUser: \"把本地文件同步到 OSS\"\n\n| Requirement | Search Phrase |\n| ----------- | ------------- |\n| Sync local files to OSS | 把本地文件同步到 OSS |\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=把本地文件同步到 OSS' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n### Example 4: Refine Weak Results\n\nIf the first search only matches surface wording, rewrite the search phrase toward the underlying capability before declaring a gap.\n\n| Requirement | Weak Search Phrase | Capability-Oriented Search Phrase |\n| ----------- | ------------------ | --------------------------------- |\n| Query internal standards before generating content | internal standards policy names | knowledge base retrieval document Q&A content citation |\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=knowledge base retrieval document Q&A content citation' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n### Example 5: Compound Request With Support Needs\n\nFor compound requests, create one searchable intent unit for each meaningful requirement or support need, then search each unit independently.\n\nUser: \"Generate an output from a source document, consult internal standards first, and handle setup or runtime blockers if needed.\"\n\n| Requirement | Search Phrase |\n| ----------- | ------------- |\n| Generate structured output from source material | document parsing content generation structured output |\n| Query internal standards before generation | knowledge base retrieval document Q&A content citation |\n| Handle setup or runtime blockers | runtime dependency installation environment troubleshooting |\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=document parsing content generation structured output' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=knowledge base retrieval document Q&A content citation' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=runtime dependency installation environment troubleshooting' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\nBefore installation, present the final de-duplicated install plan:\n\n```text\nFinal global Skills to install:\n\n| Skill Name | Solves |\n| ---------- | ------ |\n| <content-generation-skill> | Generates the requested output |\n| <knowledge-retrieval-skill> | Retrieves and cites internal standards |\n| <environment-guidance-skill> | Handles setup or runtime blockers |\n```\n\nFile v0.0.9:references/verification-method.md\n\n# Verification Methods\n\nThis document provides verification steps for each workflow in the `alibabacloud-find-skills` skill.\n\nDiscovery workflows use `curl` against AgentExplorer HTTP API.\n\n## Overview\n\nAfter executing each workflow, verify success by checking:\n\n1. `curl` exits with code `0`\n2. Response is valid JSON\n3. Response contains the expected field: `data`, `content`, or `requestId`\n4. Data content is valid and relevant\n5. Errors are handled without switching to Aliyun CLI\n\n## Workflow 1: Search Skills By Keyword\n\n### Success Criteria\n\nThe request succeeds:\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=ECS' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\necho \"Exit code: $?\"\n```\n\nExpected response fields:\n\n- `data`: array of skill objects\n- `totalCount`: number\n- `requestId`: string\n- `maxResults`: number\n\nEach skill should have:\n\n- `skillName`: non-empty string\n- `displayName`: non-empty string\n- `description`: non-empty string\n- `categoryName`: non-empty string\n- `installCount`: non-negative integer\n- `likeCount`: non-negative integer\n\n### Minimal Verification Script\n\n```bash\n#!/bin/bash\nKEYWORD=\"ECS\"\n\nRESULT=$(curl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode \"keyword=$KEYWORD\" \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=5' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\")\n\nif [ $? -ne 0 ]; then\n  echo \"search request failed\"\n  exit 1\nfi\n\necho \"$RESULT\" | grep -q '\"data\"' || { echo \"missing data\"; exit 1; }\necho \"$RESULT\" | grep -q '\"skillName\"' && echo \"skills found\" || echo \"no skills found\"\n```\n\n## Workflow 2: Browse Skills By Category\n\n### Success Criteria\n\nList categories succeeds:\n\n```bash\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/categories' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\nExpected category fields:\n\n- `data`: array\n- `code`: category code\n- `name`: category display name\n- `children`: child category array\n\nSearch by category succeeds:\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\nSearch results should contain `categoryCode` matching the requested top-level category.\n\n## Workflow 3: Get Skill Details\n\n### Success Criteria\n\nThe request succeeds with a valid skill name:\n\n```bash\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills/alibabacloud-cli-guidance' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\nExpected response fields:\n\n- `requestId`: string\n- `content`: non-empty markdown string\n\nThe `content` value should include skill frontmatter with `name:` and `description:`.\n\n## Workflow 4: Combined Search\n\n### Success Criteria\n\nCombined keyword and category search succeeds:\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=backup' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=10' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\nResults should be relevant to both the keyword and category.\n\n## Workflow 5: Paginated Category Listing\n\n### Success Criteria\n\nFirst page returns `nextToken` when more results exist:\n\n```bash\nPAGE1=$(curl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'maxResults=2' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\")\n\necho \"$PAGE1\" | grep -q '\"nextToken\"'\n```\n\nSecond page uses the returned token exactly:\n\n```bash\nNEXT_TOKEN=\"<next-token-from-previous-response>\"\n\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'maxResults=2' \\\n  --data-urlencode \"nextToken=$NEXT_TOKEN\" \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17' \\\n  -H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\nDo not invent or edit pagination tokens.\n\n## Workflow 6: Install A Skill\n\nInstallation is separate from AgentExplorer discovery.\n\n```bash\nnpx skills add aliyun/alibabacloud-aiops-skills \\\n  --skill <skill-name> \\\n  --full-depth \\\n  --agent qwen-code \\\n  -g -y\n```\n\nManual checklist:\n\n- [ ] Installation command completed without errors\n- [ ] Skill appears in the target agent's skill list\n- [ ] Skill can be triggered with appropriate keywords\n- [ ] Installed Skill's own prerequisites are followed\n\n## Error Verification\n\n### Missing `x-acs-date`\n\nIf `x-acs-date` is omitted, the API returns an error similar to:\n\n```json\n{\n  \"Code\": \"MissingDate\",\n  \"Message\": \"Date is mandatory for this action.\"\n}\n```\n\nFix by adding:\n\n```bash\n-H \"x-acs-date: $(date -u +%Y-%m-%dT%H:%M:%SZ)\"\n```\n\n### Network Failure\n\nFor DNS, proxy, or TLS errors:\n\n1. Retry once\n2. Check network/proxy access to `agentexplorer.aliyuncs.com`\n3. Report the failure with the attempted endpoint and operation\n4. Do not fall back to Aliyun CLI unless the user explicitly requests it\n\n## General Verification Checklist\n\n### Request Execution\n\n- [ ] Uses `curl`, not `aliyun`\n- [ ] Uses `https://agentexplorer.aliyuncs.com`\n- [ ] Includes `User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills`\n- [ ] Includes `x-acs-version: 2026-03-17`\n- [ ] Includes `x-acs-date`\n- [ ] Uses `--data-urlencode` for query values with spaces, Chinese text, or tokens\n\n### Response Format\n\n- [ ] Search response has `data`\n- [ ] Category response has `data`\n- [ ] Detail response has `content`\n- [ ] Error response is summarized clearly\n\n### User Presentation\n\n- [ ] Results are shown as a table or concise list\n- [ ] `skillName`, display name, category, description, and install count are included when available\n- [ ] The final install plan is de-duplicated\n- [ ] Installation is performed only when the user asked for it\n\nFile v0.0.9:skill-card.md\n\n## Description: <br>\nHelps agents search, browse, inspect, and install Alibaba Cloud Agent Skills from the AgentExplorer catalog. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[sdk-team](https://clawhub.ai/user/sdk-team) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nDevelopers and agent users use this skill to find Alibaba Cloud skills by intent, keyword, category, or skill name, then inspect matching skill details and install selected skills when requested. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill may suggest global, non-interactive installation of downstream skills. <br>\nMitigation: Review the selected downstream skill before installation, prefer explicit confirmation and non-global installation where practical, and confirm removal steps before proceeding. <br>\nRisk: Discovery and installation guidance can affect the agent environment beyond the current conversation. <br>\nMitigation: Use the skill only when Alibaba Cloud skill discovery or installation is intended, and treat install commands as persistent environment changes. <br>\n\n\n## Reference(s): <br>\n- [ClawHub Skill Page](https://clawhub.ai/sdk-team/alibabacloud-find-skills) <br>\n- [AgentExplorer API Reference](references/agentexplorer-api.md) <br>\n- [Acceptance Criteria](references/acceptance-criteria.md) <br>\n- [Verification Methods](references/verification-method.md) <br>\n- [Search Examples](references/search-examples.md) <br>\n- [Category Examples](references/category-examples.md) <br>\n- [Curl Shell Compatibility Guide](references/curl-shell-compatibility.md) <br>\n- [Supported npx skills agents](references/npx-skills-agents.md) <br>\n- [AgentExplorer HTTP API](https://agentexplorer.aliyuncs.com) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, shell commands, API calls, guidance] <br>\n**Output Format:** [Markdown responses with tables and inline curl or npx shell commands] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [May include AgentExplorer API request shapes, result summaries, installation commands, and verification guidance.] <br>\n\n## Skill Version(s): <br>\n0.0.9 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v0.0.8: 11 files, 34746 bytes\n\nFiles: references/acceptance-criteria.md (20223b), references/category-examples.md (19503b), references/cli-installation-guide.md (11622b), references/npx-skills-agents.md (798b), references/ram-policies.md (5107b), references/related-commands.md (13974b), references/search-examples.md (5094b), references/verification-method.md (17865b), skill-card.md (2724b), SKILL.md (23465b), _meta.json (143b)\n\nFile v0.0.8:SKILL.md\n\n---\nname: alibabacloud-find-skills\ndescription: >\n  Use this skill when users want to search, discover, browse, or find Alibaba Cloud (阿里云) agent skills.\n  Triggers include: \"find a skill for X\", \"search alicloud skills\", \"阿里云有什么 skill\",\"阿里云\",\n  \"搜索阿里云技能\", \"有没有管理 ECS/RDS/OSS 的 skill\", \"阿里云 skills 有哪些类目\",\n  \"帮我找一个 skill\", \"browse alicloud skills\", \"list alicloud skill categories\",\n  \"is there an alicloud skill that can...\", \"what alicloud skills are available\", \"XX Skill 的内容是什么\", \"我想了解阿里云 XX Skill 具体做什么\",\"帮我安装阿里云 Skill\",\"使用阿里云相关的skill\",\n  \"阿里云 agent skill 市场\", \"搜一下阿里云的 skill\", \"建一个数据分析项目有没有相关 skill\".\n---\n\n> [!IMPORTANT]\n> **For any Alibaba Cloud query or management task:**\n> 1. **Search** — use this skill (`alibabacloud-find-skills`) to find the relevant Skill(s).\n> 2. **Install** — install the selected Skill(s) only when the user asks to install or use them to complete the task.\n> 3. **Execute** — follow the installed Skill(s)' instructions to fulfill the request.\n\n# Alibaba Cloud Agent Skills Search & Discovery\n\nThis skill helps users search, discover, and install Alibaba Cloud official Agent Skills through the `agentexplorer` CLI plugin.\n\n## Scenario Description\n\nThis skill enables users to:\n\n1. **Search Skills** — Find Alibaba Cloud Agent Skills by intent phrase, keyword, category listing, or combined semantic search\n2. **Browse Categories** — Explore available skill categories and subcategories\n3. **View Skill Details** — Get detailed information about specific skills\n4. **Install Skills** — Guide users through skill installation when installation is requested\n\n**Architecture**: Alibaba Cloud CLI + agentexplorer Plugin → Skills Repository\n\n### Use Cases\n\n- \"Find a skill for managing ECS instances\"\n- \"What Alibaba Cloud skills are available for databases?\"\n- \"阿里云有哪些 OSS 相关的 skill?\"\n- \"Browse all available alicloud skills\"\n- \"Install a skill for RDS management\"\n\n## Installation\n\n> **Pre-check: Aliyun CLI >= 3.3.3 required**\n>\n> Run `aliyun version` to verify >= 3.3.3. If not installed or version too low,\n> run `curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash` to install/update,\n> or see [references/cli-installation-guide.md](references/cli-installation-guide.md) for installation instructions.\n\n**[MUST] CLI User-Agent (API calls only)** — Every actual API invocation (e.g., `aliyun agentexplorer ...`) must include:\n`--user-agent AlibabaCloud-Agent-Skills/alibabacloud-find-skills`\n\n> **Note**: This flag applies only to commands that hit the OpenAPI (such as `aliyun agentexplorer ...`).\n> Local/management commands like `aliyun configure ...`, `aliyun configure list`, `aliyun configure ai-mode ...`,\n> `aliyun plugin ...`, and `aliyun version` do **not** support the `--user-agent` flag — do not pass it to them.\n\n**[MUST] Endpoint** — Every `aliyun agentexplorer ...` invocation must include `--endpoint 'agentexplorer.aliyuncs.com'`.\nUse the explicit endpoint for AgentExplorer commands in this skill.\n\n### Step 1: Authenticate\n\nComplete authentication first (see the **Authentication** section below). The next steps require valid credentials.\n\n### Step 2: Enable Auto Plugin Install\n\nOnce `aliyun configure list` shows a valid profile, enable automatic plugin installation:\n\n```bash\naliyun configure set --auto-plugin-install true\n```\n\n### Step 3: Enable AI-Mode (Optional)\n\nAliyun CLI provides AI-Mode. When enabled, the CLI automatically attaches AI identity information, allowing the server to identify and optimize Agent call chains.\n\n```bash\n# Enable AI-Mode\naliyun configure ai-mode enable\n\n# Set AI-Mode user-agent identifier\naliyun configure ai-mode set-user-agent --user-agent AlibabaCloud-Agent-Skills/alibabacloud-find-skills\n\n# Disable AI-Mode\naliyun configure ai-mode disable\n```\n\n### Step 4: Update / Install Plugins\n\n```bash\n# Refresh plugin index and update installed plugins\naliyun plugin update\n\n# Install the agentexplorer plugin\naliyun plugin install --names agentexplorer\n\n# Verify installation\naliyun plugin list | grep agentexplorer\n\n# Optional: inspect command help\naliyun agentexplorer --help\n```\n\n## Authentication\n\n> **Pre-check: Alibaba Cloud Credentials Required**\n>\n> **Security Rules:**\n>\n> - **NEVER** read, echo, or print AK/SK values (e.g., `echo $ALIBABA_CLOUD_ACCESS_KEY_ID` is FORBIDDEN)\n> - **NEVER** ask the user to input AK/SK directly in the conversation or command line\n> - **NEVER** use `aliyun configure set` with literal credential values\n> - **ONLY** use `aliyun configure list` to check credential status\n>\n> ```bash\n> aliyun configure list\n> ```\n>\n> Check the output for a valid profile (AK, STS, or OAuth identity).\n>\n> **If no valid profile exists, STOP here.**\n>\n> 1. Obtain credentials from [Alibaba Cloud Console](https://ram.console.aliyun.com/manage/ak)\n> 2. Configure credentials **outside of this session** (via `aliyun configure` in terminal or environment variables in shell profile)\n> 3. Return and re-run after `aliyun configure list` shows a valid profile\n\n## RAM Policy\n\nThis skill uses read-only APIs from the AgentExplorer service. Required permissions: `agentexplorer:ListCategories`, `agentexplorer:SearchSkills`, `agentexplorer:GetSkillContent`. For the full RAM policy JSON, see [references/ram-policies.md](references/ram-policies.md).\n\n> **[MUST] Permission Failure Handling:** When any command or API call fails due to permission errors at any point during execution, follow this process:\n>\n> 1. Read `references/ram-policies.md` to get the full list of permissions required by this SKILL\n> 2. Use `ram-permission-diagnose` skill to guide the user through requesting the necessary permissions\n> 3. Pause and wait until the user confirms that the required permissions have been granted\n\nFor detailed permission information, see [references/ram-policies.md](references/ram-policies.md).\n\n## Core Workflow\n\n### Step 1: Understand What They Need\n\nBefore searching, identify:\n\n1. **Domain** — The relevant area or Alibaba Cloud product family, e.g., ECS, RDS, OSS, SLS, PAI, testing, deployment, data analysis.\n2. **Specific task** — What the user wants to do, e.g., diagnose ECS issues, sync files to OSS, build a data analysis project, review permissions.\n3. **Skill likelihood** — Whether this is a common enough task that an existing Skill likely exists.\n4. **Category fit** — Whether the domain obviously maps to a known category. Do not call `list-categories` during initial understanding unless the user explicitly asks to browse categories.\n\nUse this understanding to form the search text. `--keyword` supports both short keywords and full intent phrases. Because `search-skills` uses semantic matching against Skill descriptions, prefer the user's intent when available, such as `建一个数据分析项目`, instead of reducing every request to a single product word.\n\nBefore 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.\n\nThe `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.\n\nIf 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.\n\n### Step 2: Search Skills\n\nDefault to semantic intent search for task-matching requests. Use category listing when the user asks to list or browse all Skills under a category.\n\n- **Intent search (default for task matching)**: Use the user's task or full intent phrase as `--keyword`, with `--search-mode semantic`.\n- **Keyword search**: Use concise product/task keywords with `--search-mode semantic` when the intent is broad, noisy, or already names a product/capability.\n- **Category browsing**: Call `list-categories` when the user asks for available categories or when a category code must be confirmed.\n- **List skills in a category**: When the user asks to list all Skills in a category, use `--category-code` only. Do not pass `--keyword` or `--search-mode semantic`; this mode supports pagination.\n- **Combined semantic search**: After category selection, use both `--keyword` and `--category-code` with `--search-mode semantic` only when the user asks for best matches inside that category.\n\nChoose one command shape based on the user request. Use `--search-mode semantic` for intent, keyword, and combined semantic search. Omit `--search-mode semantic` for category listing so pagination can be used. AgentExplorer calls must use `--endpoint 'agentexplorer.aliyuncs.com'`. If `--search-mode` is not shown in `aliyun agentexplorer search-skills --help`, install or update the `agentexplorer` plugin from the Installation section.\n\n```bash\n# Intent search (default for task matching)\naliyun agentexplorer search-skills \\\n  --keyword \"<user-intent>\" \\\n  --search-mode semantic \\\n  --max-results 20 \\\n  --endpoint 'agentexplorer.aliyuncs.com' \\\n  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-find-skills\n\n# Keyword search\naliyun agentexplorer search-skills \\\n  --keyword \"<product-or-task-keyword>\" \\\n  --search-mode semantic \\\n  --max-results 20 \\\n  --endpoint 'agentexplorer.aliyuncs.com' \\\n  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-find-skills\n\n# Get all categories before listing skills in a category\naliyun agentexplorer list-categories \\\n  --endpoint 'agentexplorer.aliyuncs.com' \\\n  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-find-skills\n\n# List skills in a category\naliyun agentexplorer search-skills \\\n  --category-code \"<category-code>\" \\\n  --max-results 20 \\\n  --endpoint 'agentexplorer.aliyuncs.com' \\\n  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-find-skills\n\n# Fetch the next category page if nextToken is returned\naliyun agentexplorer search-skills \\\n  --category-code \"<category-code>\" \\\n  --max-results 20 \\\n  --next-token \"<next-token-from-previous-response>\" \\\n  --endpoint 'agentexplorer.aliyuncs.com' \\\n  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-find-skills\n\n# Combined semantic search after category selection\naliyun agentexplorer search-skills \\\n  --keyword \"<user-intent-or-keyword>\" \\\n  --category-code \"<category-code>\" \\\n  --search-mode semantic \\\n  --max-results 20 \\\n  --endpoint 'agentexplorer.aliyuncs.com' \\\n  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-find-skills\n```\n\n### Step 3: Iterate Until Found\n\nIf 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:\n\n1. Start with the user's full intent phrase when available\n2. Extract direct product/task keywords from the request\n3. Switch between Chinese and English terms (\"cloud server\" → \"ECS\", \"object storage\" → \"OSS\")\n4. Broaden or simplify keywords (drop qualifiers: \"RDS backup automation\" → \"RDS\")\n5. Use `list-categories`, select the best category, then retry with combined search\n6. Try synonyms or related terms (\"instance\" → \"ECS\", \"bucket\" → \"OSS\")\n\nDo not conclude \"no dedicated Skill exists\" until you have tried at least one capability-oriented search phrase for that intent unit.\n\nRepeat 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.\n\n### Step 4: View Skill Details (Optional)\n\nOptionally retrieve skill content to verify it matches user intent before installation. This step can be skipped if the search results already provide sufficient information.\n\n```bash\naliyun agentexplorer get-skill-content \\\n  --skill-name \"<skill-name>\" \\\n  --endpoint 'agentexplorer.aliyuncs.com' \\\n  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-find-skills\n```\n\n### Step 5: Install Selected Skill(s)\n\nSkip 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.\n\n```bash\n# Option A: Using npx skills add\n# By default this command is interactive (blocks for user input).\n# Recommended: use non-interactive mode to avoid blocking.\n#   --agent <client>   Agent client to install for (see references/npx-skills-agents.md)\n#   -g                 Install globally (home dir); omit for project-local install\n#   -y                 Skip confirmation (requires --agent and -g/-local to be set)\nnpx skills add aliyun/alibabacloud-aiops-skills \\\n  --skill <skill-name> \\\n  --full-depth \\\n  --agent qwen-code \\\n  -g -y\n\n# Option B: Using npx clawhub install (OpenClaw ecosystem)\nnpx clawhub install <selected-skill-name>\n```\n\nVerify each selected Skill appears in the available skills list after installation.\n\n## Command Reference\n\nFor complete parameter details and search parameter rules, see [references/related-commands.md](references/related-commands.md).\n\n## Success Verification\n\nAfter each operation, verify success by checking:\n\n1. **List Categories**: Response contains categoryCode and categoryName fields\n2. **Search Skills**: Response contains skills array with valid skill objects\n3. **Get Skill Content**: Response contains complete skill markdown content\n4. **Install Selected Skill(s)**: Each selected Skill appears in Claude Code skills list\n\nFor detailed verification steps, see [references/verification-method.md](references/verification-method.md).\n\n## Search Strategies\n\n### 1. Intent Analysis for Search\n\nBefore 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.\n\nFor each meaningful requirement, identify:\n\n- **Action**: What operation is needed, e.g., query, generate, diagnose, deploy, install, validate, transform\n- **Object**: What the operation applies to, e.g., document, knowledge base, video, script, database, CLI environment\n- **Context/source**: Where the information or resource comes from, e.g., internal docs, cloud service, local file, OSS, database, runtime environment\n- **Expected output**: What the user expects back, e.g., answer with citations, generated script, report, command guidance, installed dependency\n- **Support needs**: Whether the request also needs credentials, plugins, permissions, runtime dependencies, environment checks, or troubleshooting\n\nTreat explicit support, blocker, and fallback clauses as searchable intents, even when they are conditional. This includes requirements about setup, access, authorization, credentials, 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.\n\nThen form one or more searchable intent phrases using:\n\n`<action> + <object/capability> + <context/source> + <expected output>`\n\nFor compound requests, create one searchable intent unit per meaningful requirement and search each unit independently. Do not assume one Skill covers the whole request unless the search result clearly states that it does.\n\nA single searchable intent unit may still require multiple complementary Skills. When one Skill covers the main action but another Skill is needed for supporting needs such as credentials, plugins, runtime setup, permissions, data access, or validation, select both and explain their roles separately.\n\n### 2. Search Text Selection\n\n- **Use intent phrases first**: Prefer the user's natural-language task or requirement, e.g., \"建一个数据分析项目\", \"把本地文件同步到 OSS\"\n- **Use product/task keywords when intent is broad or noisy**: Extract concise product and action terms, e.g., \"ECS 诊断\", \"OSS 同步\"\n- **Use product codes as fallback or refinement**: `ecs`, `rds`, `oss`, `slb`, `vpc`\n- **Use Chinese and English variants**: e.g., \"云服务器\" / \"ECS\", \"对象存储\" / \"OSS\"\n- **Use broader terms only after specific intent searches fail**: e.g., \"compute\", \"storage\", \"network\"\n\n### 3. Category Filtering\n\n- **Browse when needed**: Use `list-categories` when the user asks about categories or when the domain should narrow the search\n- **Select the best category**: Map the domain to the closest `categoryCode`, then use it in `--category-code`\n- **Combine with intent**: For clear tasks inside a clear domain, use the task phrase as `--keyword` and the selected category as `--category-code`\n\n### 4. Result Optimization\n\n- **Start with intent**: Begin with the user's task description, then add category filtering only when the domain is clear or initial results are too broad\n- **Keep complementary Skills together**: If one Skill handles the main task and another handles required setup, access, validation, or troubleshooting, include both instead of choosing only the top-ranked main Skill\n- **Check install counts**: Popular skills usually have higher install counts\n- **Read descriptions**: Match skill description to your specific use case\n\n### 5. When No Results Found\n\n```bash\n# Strategy 1: Try the full user intent\n# Instead of just \"OSS\", try \"把本地文件同步到 OSS\"\n\n# Strategy 2: Extract product/task keywords\n# Instead of \"云服务器故障排查\", try \"ECS 诊断\"\n\n# Strategy 3: Try Chinese and English variants\n# Instead of \"云服务器\" try \"ECS\" or \"instance\"\n\n# Strategy 4: Use broader terms\n# Instead of \"RDS backup automation\" try just \"RDS\" or \"database\"\n\n# Strategy 5: Browse or filter by category\naliyun agentexplorer list-categories \\\n  --endpoint 'agentexplorer.aliyuncs.com' \\\n  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-find-skills\n\naliyun agentexplorer search-skills \\\n  --keyword \"ECS 实例管理\" \\\n  --category-code \"<selected-category-code>\" \\\n  --search-mode semantic \\\n  --max-results 20 \\\n  --endpoint 'agentexplorer.aliyuncs.com' \\\n  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-find-skills\n```\n\n### 6. Display Results to Users\n\nWhen presenting search results, format as table:\n\n```\nFound N skills:\n\n| Skill Name | Display Name | Description | Category | Install Count |\n|------------|--------------|-------------|----------|---------------|\n| alibabacloud-ecs-batch | ECS Batch Operations | Batch manage ECS instances | Computing > ECS | 245 |\n| ... | ... | ... | ... | ... |\n```\n\nInclude:\n\n- **skillName**: For installation and detailed queries\n- **displayName**: User-friendly name\n- **description**: Brief overview\n- **categoryName** + **subCategoryName**: Classification\n- **installCount**: Popularity indicator\n\n## Cleanup\n\nThis skill does not create any resources. No cleanup is required.\n\n## Best Practices\n\n1. **Verify credentials first** — Use `aliyun configure list` before AgentExplorer operations\n2. **Choose the right search mode** — Use semantic intent or keyword search for task matching; use category listing without `--search-mode semantic` when the user asks to list all Skills in a category\n3. **Search by intent units** — Split compound requests into meaningful capability and support needs, then search each unit independently\n4. **Refine weak results** — If results only match surface wording or miss an intent unit, rewrite the phrase toward the underlying capability and retry before declaring a gap\n5. **Keep complementary Skills together** — Select multiple Skills when one covers the main task and another covers required setup, access, validation, troubleshooting, or runtime support\n6. **Display results clearly** — Use tables with `skillName`, display name, category, description, and install count\n7. **Install only when requested** — Do not install for list-only, browse-only, or compare-only requests\n8. **Verify before installation** — Use `get-skill-content` when search results are not sufficient to confirm fit\n9. **Verify after installation** — Confirm every selected Skill is available after installation\n\n## Common Use Cases & Examples\n\nFor examples, see [references/search-examples.m\n\nArchive v0.0.7: 10 files, 31145 bytes\n\nFiles: references/acceptance-criteria.md (18596b), references/category-examples.md (18572b), references/cli-installation-guide.md (11622b), references/npx-skills-agents.md (798b), references/ram-policies.md (5001b), references/related-commands.md (13100b), references/verification-method.md (17369b), skill-card.md (2877b), SKILL.md (18415b), _meta.json (143b)\n\nArchive v0.0.6: 10 files, 31179 bytes\n\nFiles: references/acceptance-criteria.md (18570b), references/category-examples.md (18572b), references/cli-installation-guide.md (11622b), references/npx-skills-agents.md (798b), references/ram-policies.md (5001b), references/related-commands.md (13100b), references/verification-method.md (17356b), skill-card.md (3088b), SKILL.md (18398b), _meta.json (143b)\n\nArchive v0.0.5: 8 files, 28823 bytes\n\nFiles: references/acceptance-criteria.md (18609b), references/category-examples.md (18572b), references/cli-installation-guide.md (11622b), references/ram-policies.md (5001b), references/related-commands.md (13100b), references/verification-method.md (17356b), SKILL.md (17492b), _meta.json (143b)\n\nArchive v0.0.4: 9 files, 29680 bytes\n\nFiles: references/acceptance-criteria.md (16452b), references/category-examples.md (17359b), references/cli-installation-guide.md (11622b), references/ram-policies.md (4938b), references/related-commands.md (11858b), references/verification-method.md (16698b), scripts/validate-skill.sh (5466b), SKILL.md (16654b), _meta.json (143b)\n\nArchive v0.0.3: 9 files, 29465 bytes\n\nFiles: references/acceptance-criteria.md (16452b), references/category-examples.md (16095b), references/cli-installation-guide.md (11622b), references/ram-policies.md (4813b), references/related-commands.md (11133b), references/verification-method.md (16023b), scripts/validate-skill.sh (5416b), SKILL.md (15831b), _meta.json (143b)\n\nArchive v0.0.2: 9 files, 29200 bytes\n\nFiles: references/acceptance-criteria.md (16276b), references/category-examples.md (16095b), references/cli-installation-guide.md (11622b), references/ram-policies.md (4813b), references/related-commands.md (11133b), references/verification-method.md (16023b), scripts/validate-skill.sh (5416b), SKILL.md (15849b), _meta.json (143b)\n\nArchive v0.0.1: 9 files, 29199 bytes\n\nFiles: references/acceptance-criteria.md (16248b), references/category-examples.md (16095b), references/cli-installation-guide.md (11622b), references/ram-policies.md (4813b), references/related-commands.md (11133b), references/verification-method.md (15820b), scripts/validate-skill.sh (5416b), SKILL.md (15843b), _meta.json (143b)","readmeExcerpt":"Skill: Alibabacloud Find Skills Owner: sdk-team Summary: Use this skill when users want to search, discover, browse, or find Alibaba Cloud (阿里云) agent skills. Triggers include: \"find a skill for X\", \"search aliclou... Tags: latest:0.0.10 Version history: v0.0.10 | 2026-06-24T07:09:11.478Z | auto alibabacloud-find-skills 0.0.10 - Removed all instructions and code referencing the dynamic x-acs-date header in API calls;","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"# Bash-compatible header snippet for macOS, Linux, WSL, and Git Bash.\n# On Windows, use the PowerShell command shape below instead.\n-H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n-H 'x-acs-version: 2026-03-17'"},{"language":"bash","snippet":"curl -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=<user-intent-or-keyword>' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'"},{"language":"bash","snippet":"curl -sS --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/categories' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'"},{"language":"bash","snippet":"curl -sS --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills/<skillName>' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'"},{"language":"bash","snippet":"# Bash-compatible examples for macOS, Linux, WSL, and Git Bash.\n# On Windows, use the PowerShell command shape below and replace endpoint/query parameters.\n\n# Search skills\ncurl -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=<user-intent-or-keyword>' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n\n# List categories\ncurl -sS --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/categories' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n\n# Get skill content\ncurl -sS --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills/<skillName>' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'"},{"language":"powershell","snippet":"powershell -NoProfile -Command \"curl.exe -sS -G --connect-timeout 10 --max-time 30 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' --data-urlencode 'keyword=<user-intent-or-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'\""}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: alibabacloud-find-skills\ndescription: >\n  Use this skill when users want to search, discover, browse, or find Alibaba Cloud (阿里云) agent skills.\n  Triggers include: \"find a skill for X\", \"search alicloud skills\", \"阿里云有什么 skill\",\"阿里云\",\n  \"搜索阿里云技能\", \"有没有管理 ECS/RDS/OSS 的 skill\", \"阿里云 skills 有哪些类目\",\n  \"帮我找一个 skill\", \"browse alicloud skills\", \"list alicloud skill categories\",\n  \"is there an alicloud skill that can...\", \"what alicloud skills are available\", \"XX Skill 的内容是什么\", \"我想了解阿里云 XX Skill 具体做什么\",\"帮我安装阿里云 Skill\",\"使用阿里云相关的skill\",\n  \"阿里云 agent skill 市场\", \"搜一下阿里云的 skill\", \"建一个数据分析项目有没有相关 skill\".\n---\n\n> [!IMPORTANT]\n> **For any Alibaba Cloud query or management task:**\n> 1. **Search** — use this skill (`alibabacloud-find-skills`) to find the relevant Skill(s).\n> 2. **Install** — install the selected Skill(s) only when the user asks to install or use them to complete the task.\n> 3. **Execute** — follow the installed Skill(s)' instructions to fulfill the request.\n\n# Alibaba Cloud Agent Skills Search & Discovery\n\nThis skill helps users search, discover, and install Alibaba Cloud official Agent Skills from the AgentExplorer catalog.\n\n## Scenario Description\n\nThis skill enables users to:\n\n1. **Search Skills** — Find Alibaba Cloud Agent Skills by intent phrase, keyword, category listing, or combined semantic search\n2. **Browse Categories** — Explore available skill categories and subcategories\n3. **View Skill Details** — Get detailed information about specific skills\n4. **Install Skills** — Guide users through skill installation when installation is requested\n\n**Architecture**: `curl` + AgentExplorer HTTP API → Skills Repository\n\nDiscovery 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.\n\n### Use Cases\n\n- \"Find a skill for managing ECS instances\"\n- \"What Alibaba Cloud skills are available for databases?\"\n- \"阿里云有哪些 OSS 相关的 skill?\"\n- \"Browse all available alicloud skills\"\n- \"Install a skill for RDS management\"\n\n## AgentExplorer HTTP API\n\n**Base URL**: `https://agentexplorer.aliyuncs.com`\n\nEvery AgentExplorer HTTP request must include these headers.\n\n```bash\n# Bash-compatible header snippet for macOS, Linux, WSL, and Git Bash.\n# On Windows, use the PowerShell command shape below instead.\n-H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n-H 'x-acs-version: 2026-03-17'\n```\n\nEvery AgentExplorer HTTP `curl` / `curl.exe` request must include `--connect-timeout 10 --max-time 30`.\n\n### Shell-compatible curl usage\n\nBefore 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.\n\n### API Shapes\n\n#### Bash-compatible Examples\n\n```bash\n# Bash-compatible examples for macOS, Linux, WSL, and Git Bash."},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn74p5w8ywv6prh40g0s82gmqh83nw54\",\n  \"slug\": \"alibabacloud-find-skills\",\n  \"version\": \"0.0.10\",\n  \"publishedAt\": 1782284951478\n}"},{"path":"references/acceptance-criteria.md","content":"# Acceptance Criteria: alibabacloud-find-skills\n\n**Skill Name**: `alibabacloud-find-skills`\n**Purpose**: Validate correct AgentExplorer HTTP API usage and skill-discovery behavior.\n\n## Discovery Prerequisites\n\n### Correct\n\nThe discovery workflow uses `curl` directly:\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=ECS' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n### Incorrect\n\n```bash\naliyun version\naliyun plugin search agentexplorer\naliyun plugin install --names aliyun-cli-agentexplorer\naliyun plugin update --name aliyun-cli-agentexplorer\naliyun agentexplorer search-skills --keyword \"ECS\"\naliyun configure list\n```\n\n**Why**: Finding, browsing, and inspecting Skills uses direct HTTP requests and no longer requires Aliyun CLI or the AgentExplorer CLI plugin.\n\n## HTTP API Patterns\n\n### 1. Search Skills\n\n#### Correct\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=RDS backup automation' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n#### Incorrect\n\n```bash\n# Missing -G: query params are not appended as intended\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=RDS backup automation'\n\n# Wrong parameter names from CLI mode\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'search-mode=semantic' \\\n  --data-urlencode 'max-results=20'\n\n# Wrong endpoint path\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/search-skills'\n```\n\n**Why**: HTTP query parameters use API names such as `searchMode`, `maxResults`, `categoryCode`, and `nextToken`.\n\n### 2. List Categories\n\n#### Correct\n\n```bash\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/categories' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n#### Incorrect\n\n```bash\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/category'\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/list-categories'\n```\n\n### 3. Get Skill Content\n\n#### Correct\n\n```bash\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills/alibabacloud-cli-guidance' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n#### Incorrect\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'skillName=alibabacloud-cli-guidance'\n\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skill/alibabacloud-cli-guidance'\n```\n\n**Why**: Skill content uses a path parameter: `/openapi/for-agent/skills/{skillName}`.\n\n## Header "},{"path":"references/agentexplorer-api.md","content":"# AgentExplorer HTTP API Reference\n\nComplete reference for HTTP requests used by the `alibabacloud-find-skills` skill.\n\nDiscovery uses `curl` directly. Do not install Aliyun CLI or the `agentexplorer` CLI plugin for this skill's search, browse, or detail workflows.\n\n## Common Request Headers\n\nEvery AgentExplorer request must include:\n\n```bash\n-H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n-H 'x-acs-version: 2026-03-17'\n```\n\nFor Windows PowerShell, Command Prompt, macOS, Linux, WSL, and Git Bash curl templates, see [curl-shell-compatibility.md](curl-shell-compatibility.md).\n\n## API Summary\n\n| API | Purpose | Required values |\n| --- | --- | --- |\n| `GET /openapi/for-agent/skills` | Search or list skills | Common headers; query params depend on mode |\n| `GET /openapi/for-agent/categories` | List skill categories | Common headers |\n| `GET /openapi/for-agent/skills/{skillName}` | Get skill details | Common headers; path `skillName` |\n\nBase URL:\n\n```text\nhttps://agentexplorer.aliyuncs.com\n```\n\n## 1. Search Or List Skills\n\n**Endpoint**:\n\n```text\nGET https://agentexplorer.aliyuncs.com/openapi/for-agent/skills\n```\n\n**Query parameters**:\n\n| Parameter | Required | Description |\n| --- | --- | --- |\n| `keyword` | No | Search keyword or full intent phrase |\n| `categoryCode` | No | Top-level category code, dot-form child category, or comma-separated category list |\n| `searchMode` | Conditional | Use `semantic` for intent/keyword/combined search; omit for pure category listing |\n| `maxResults` | No | Maximum results per page, default `20`, max `100` |\n| `nextToken` | No | Pagination token returned by the previous response |\n| `skip` | No | Number of records to skip; prefer `nextToken` for pagination |\n\n### Semantic Intent Or Keyword Search\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=<keyword-or-intent>' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n### List Skills In A Category\n\nUse when the user asks to list or browse all Skills under a category. Do not pass `keyword` or `searchMode=semantic`.\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=<category-code>' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\nFetch the next page only when `nextToken` is returned:\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=<category-code>' \\\n  --data-urlencode 'maxResults=20' \\\n  --data-urlencode 'nextToken=<next-token-from-previous-response>' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n### Combined Semantic Search\n\nUse only after category se"},{"path":"references/category-examples.md","content":"# Category Examples\n\nThis reference provides common category codes and examples for navigating the Alibaba Cloud Agent Skills catalog.\n\nFor the complete, current category list, call:\n\n```bash\ncurl -sS 'https://agentexplorer.aliyuncs.com/openapi/for-agent/categories' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n## Category Code Format\n\n- Top-level category: use the category code directly, e.g. `computing`\n- Child category: when supported, use dot notation, e.g. `computing.ecs`\n- Multiple categories: comma-separate codes, e.g. `computing,database`\n- If child code filtering is uncertain, confirm with `/openapi/for-agent/categories`, then use either dot notation or a semantic `keyword`\n\n## Common Categories\n\n| Code | Name | Typical Domains |\n| --- | --- | --- |\n| `computing` | 计算 | ECS, ECI, EHPC, ComputeNest, Alibaba Cloud Linux |\n| `aiml` | 人工智能与机器学习 | PAI, Bailian, OpenSearch, AgentBay |\n| `developertools` | 开发工具 | CLI guidance, developer workflows |\n| `storage` | 存储 | OSS, SLS, Tablestore, PDS, HBR |\n| `migrationom` | 迁移与运维管理 | OOS, Terraform import, resource management |\n| `netcdn` | 网络与CDN | NIS, SAG, DCDN |\n| `middleware` | 中间件 | CMS, API Gateway, PTS, STAROps |\n| `doweb` | 域名与网站 | Domain, ICP filing, website building |\n| `security` | 安全 | SAS, WAF, KMS, CFW, DDoS |\n| `database` | 数据库 | RDS, PolarDB, Tair, MongoDB, DTS, DMS |\n| `analyticscomputing` | 大数据计算 | DataWorks, MaxCompute, Flink, Hologres, Elasticsearch, Milvus |\n| `entcmc` | 企业服务与云通信 | SMS, voice, Chat App |\n| `mediaservices` | 媒体服务 | Live, MTS, ICE |\n| `others` | 其他 | General solutions |\n| `playbooks` | 场景化实战 | Troubleshooting and optimization playbooks |\n| `solutions` | 阿里云级跨产品类目解决方案 | Cross-product solutions |\n\n## Example Searches\n\n### Browse A Top-Level Category\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n### Search Within A Category\n\n```bash\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=RDS backup automation' \\\n  --data-urlencode 'categoryCode=database' \\\n  --data-urlencode 'searchMode=semantic' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n```\n\n### Try A Child Category Or Product Keyword\n\n```bash\n# Child category form, when supported\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'categoryCode=computing.ecs' \\\n  --data-urlencode 'maxResults=20' \\\n  -H 'User-Agent: AlibabaCloud-Agent-Skills/alibabacloud-find-skills' \\\n  -H 'x-acs-version: 2026-03-17'\n\n# Product keyword fallback\ncurl -sS -G 'https://agentexplorer.aliyuncs.com/openapi/for-agent/skills' \\\n  --data-urlencode 'keyword=ECS i"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":1862,"uniquenessScore":31,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T18:27:56.901Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T18:27:56.901Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T23:29:53.231Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}