在 Agent 客户端（Claude Code、Cursor、Qoder 等）中安装第一个阿里云官方 Skill，让 Agent 以自然语言搜索和管理云资源，完成阿里云 Skills 门户快速入门。
前提条件
阿里云账号：已完成实名认证。
阿里云 CLI：已安装 CLI并配置配置身份凭证，版本 3.3.3 及以上。运行
aliyun version确认版本号，运行aliyun configure list确认凭证配置就绪。资源中心服务：已开通资源中心服务。如未开通，运行 CLI
aliyun resourcecenter enable-resource-center开通。RAM 用户需具备AliyunResourceCenterReadOnlyAccess权限策略。Node.js 18+：Skill 安装命令使用
npx，需要 Node.js 18 或更高版本。运行node --version确认版本号。Agent 客户端：已安装支持 Skills 的 Agent 客户端。以下以 Cursor、Claude Code 和 Qoder 为例，其他客户端的配置方式类似。
操作步骤
步骤一：浏览 Skills 门户并选择一个 Skill
访问 Skills 门户。
在页面顶部搜索框中输入功能关键词（如“资源搜索”），或按产品类别浏览。
点击目标 Skill 进入详情页。详情页包含 Skill 能力范围、安装命令和示例 prompt。以下以资源中心全局资源搜索（
alibabacloud-resourcecenter-search）为例。
步骤二：安装 Skill
在 Skill 详情页顶部点击安装引导，根据提示选择安装选项后复制命令，在终端中执行。如遇网络问题，也可通过下载方式安装。
通过 CLI 命令安装（推荐）
Skill 详情页点击安装引导后，依次完成三步配置：
选择安装工具：Skills CLI（通用安装工具，支持多种 Agent 客户端）或 ClawHub CLI（OpenClaw 生态专属工具）。
选择 Agent 客户端：选择 Skill 安装到哪个客户端。
选择安装范围：当前项目或全局安装。
当前项目：Skill 仅在当前项目可用，可随项目提交到 Git。安装路径为项目根目录下
.{client}/skills/。全局：Skill 在所有项目中可用。安装路径为
~/.{client}/skills/。说明同名 Skill 同时存在于项目和全局时，project 优先生效。
配置完成后，页面底部自动生成安装命令。点击复制图标将命令粘贴到终端执行。
Skills CLI 生成的命令格式如下：
npx skills add aliyun/alibabacloud-aiops-skills --skill <skill-name> --agent <client> -y --full-depth全局安装时命令中自动添加 -g 参数，无需手动添加。
如果使用 OpenClaw 生态，可选择 ClawHub CLI，命令更简洁：
npx clawhub install <skill-name>ClawHub CLI 无需指定客户端和安装范围。
命令执行后，CLI 提示确认安装 skills@latest 版本，输入 y 后按回车。安装完成后 Skill 文件写入对应客户端的 skills 目录，重启客户端即可使用。
运行以下命令验证安装结果：
npx skills ls如果安装到了全局，使用 -g 参数查看：
npx skills ls -g通过下载安装
如果 npx skills add 因网络问题执行失败，可通过 Skills 门户手动下载安装。
在 Skill 详情页点击安装引导，切换到下载安装 tab。
点击下载 ZIP 包。
将 ZIP 文件解压到任意目录。
将解压后的 Skill 文件夹复制到对应 Agent 客户端的 skills 目录：
Agent 客户端
Skills 目录
Claude Code
.claude/skills/Cursor
.cursor/skills/Qoder
.qoder/skills/Qwen Code
.qwen-code/skills/Codex
.codex/skills/OpenClaw
./skills/Gemini CLI
.gemini/skills/GitHub Copilot
.github-copilot/skills/重启 Agent 客户端。确认目标 skills 目录中存在 SKILL.md 文件，重启客户端后输入与 Skill 相关的指令验证是否生效。
项目级安装放在项目根目录下的 skills 目录（如 .claude/skills/），全局安装放在用户主目录下（如 ~/.claude/skills/）。
步骤三：在 Agent 客户端中使用 Skill
安装完成后，重启 Agent 客户端以加载新安装的 Skill。以Claude Code、Cursor、Qoder为例：
在 Claude Code 中使用
在终端中进入已安装 Skill 的项目目录。
启动 Claude Code：
claude输入任务指令：
帮我搜索一下当前账号下有哪些 ECS 实例
Claude Code 自动匹配 Skill，读取指令，调用 aliyun resourcecenter search-resources 命令搜索云资源。
在 Cursor 中使用
在 Cursor 中打开已安装 Skill 的项目。
打开 Agent 模式（
Cmd+L或Ctrl+L打开聊天面板，切换到 Agent 模式）。输入任务指令：
帮我搜索一下当前账号下有哪些 ECS 实例
Agent 匹配到资源搜索的 Skill 后，读取 SKILL.md 并按步骤执行：验证 CLI 凭证，调用 aliyun resourcecenter search-resources 命令搜索云资源。
在 Qoder 中使用
在 Qoder 中打开已安装 Skill 的项目。
在对话面板中输入任务指令：
帮我搜索一下当前账号下有哪些 ECS 实例
Qoder 自动匹配 Skill，读取指令，调用 aliyun resourcecenter search-resources 命令搜索云资源。
预期结果
Agent 执行完成后，输出类似以下内容：
# ECS 实例搜索结果
共找到 **3 个** ECS 实例。
| 实例 ID | 实例名称 | 地域 | 状态 | 规格 |
|---------|---------|------|------|------|
| i-bp1abc**** | web-server-01 | cn-hangzhou | Running | ecs.g6.large |
| i-bp2def**** | db-server-01 | cn-hangzhou | Running | ecs.r6.xlarge |
| i-bp3ghi**** | test-instance | cn-shanghai | Stopped | ecs.c6.large |如果账号下暂无资源，返回空列表属于正常现象。
实际输出因Agent和对接模型的不同，以及账号下的资源数量和配置而异。
步骤四：尝试更多操作
确认 Skill 工作正常后，尝试更复杂的任务。以下指令均由资源中心全局资源搜索 Skill 支持：
按地域搜索资源
帮我看看华东1（杭州）地域下有哪些云资源Agent 按 Skill 定义的流程执行：调用 aliyun resourcecenter search-resources 按地域过滤，以表格形式展示匹配的资源列表。
统计资源分布
帮我统计一下当前账号下各产品类型的资源数量Agent 调用 aliyun resourcecenter get-resource-counts 获取各产品类型的资源统计，展示资源分布概览。
安装多个 Skill
同时安装多个 Skill，让 Agent 具备更全面的能力。如同时安装以下4个Skill可串联“资源搜索 → ECS 实例诊断 → 网络可达性分析 → 安全态势查询”的排障链路。
alibabacloud-resourcecenter-searchalibabacloud-ecs-diagnosealibabacloud-network-reachability-analysisalibabacloud-sas-overview
安装多个 Skill 后，Agent 可在一次对话中组合使用不同 Skill 完成复合任务。例如运维接到业务反馈“ECS 上的应用偶发访问超时”，需要快速定界是实例自身、网络链路还是安全事件导致：
业务反馈 ECS 实例 i-bp1xxxxxxx 上的应用从公网访问偶发超时，帮我先诊断这台实例自身的健康状况，再分析从公网到该实例 80 端口的网络可达性，最后看下云安全中心最近 24 小时有没有相关安全告警。更新已安装的 Skill
再次运行安装命令或者重新下载Skill 即可获取最新版本，例如：
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-resourcecenter-search --full-depthSkills 门户的 Skill 详情页会展示最近更新时间，据此判断是否需要更新本地版本。
常见问题
为什么安装命令执行成功，但 Agent 客户端识别不到已安装的 Skill？
Agent 未识别已安装的 Skill，通常由安装目录与运行目录不匹配、客户端未重新加载或 Skill 文件不完整导致。按以下顺序排查：
确认在正确的项目目录中执行了安装命令。Skill 默认安装到项目级目录
.<client>/skills/，不会自动在其它项目中生效；如需跨项目使用，请加-g参数全局安装。安装完成后重启 Agent 客户端，或在客户端中重新打开当前项目，让其重新扫描 Skill 目录。
运行
ls .<client>/skills/<skill-name>/确认SKILL.md文件存在。如文件缺失或目录为空，删除该目录后重新执行安装命令。同名 Skill 同时安装在
project与global时，project 目录优先生效。如全局更新后未生效，请检查项目目录下是否有旧版本残留。
为什么 npx skills add 命令执行失败？
安装命令失败通常与本地 Node.js 环境、网络或目录权限有关，可按以下顺序排查：
报错
command not found: npx时，运行node --version确认 Node.js 已安装且版本不低于 18；如未安装，参考 Node.js 官网 安装。报错网络超时或下载缓慢时，检查本地网络连接，然后重试。
报错权限错误（如
EACCES、permission denied）时，避免使用sudo运行npx，改为检查并修复当前用户对项目目录的写入权限。报错
404 Not Found或 Skill 名称不存在时，前往 Skills 门户 复核 Skill 的 identifier 是否拼写正确、是否已发布。
为什么 Agent 调用 Skill 时报错？
Agent 调用 Skill 时报错通常与阿里云 CLI 凭证、RAM 权限或资源中心服务状态有关，可按以下顺序排查：
报错认证失败时，运行
aliyun sts get-caller-identity确认当前 CLI 凭证有效且未过期；如失效，重新执行aliyun configure配置。报错权限不足（如
Forbidden.RAM、NoPermission）时，前往 RAM 控制台，为当前 RAM 用户或角色添加权限策略（资源中心搜索需要AliyunResourceCenterReadOnlyAccess权限），再让 Agent 重试。报错资源中心未开通（如
ServiceNotEnabled）时，运行aliyun resourcecenter enable-resource-center开通服务后重试。报错涉及具体云产品 API（如 ECS、SAS）时，参考对应云产品文档进一步为 RAM 用户补齐对应产品的权限。