[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7E71J0Y6DM9CH3P12436Z2C":3,"skill-same:01M7E71J0Y6DM9CH3P12436Z2C":70},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":30,"commitSha":31,"skillDirectory":32,"forksCount":14,"repositoryHtmlUrl":33,"repositoryHomepageUrl":6,"ownerHtmlUrl":34,"ownerBlogUrl":35,"ownerDescription":36,"updatedAt":37,"install":38,"resources":51},"01M7E71J0Y6DM9CH3P12436Z2C","alibabacloud-cli-guidance",null,"Guide users to manage Alibaba Cloud resources using the Aliyun CLI command-line tool. Covers CLI installation, credential configuration, plugin management, command construction, and error troubleshooting. Use this skill when the user wants to operate Alibaba Cloud services from the terminal — including ECS (云服务器, cloud servers), Function Compute (函数计算, serverless), RDS (云数据库, databases), OSS (对象存储, object storage), SLS (日志服务, log service), VPC (专有网络, networking), ESS (弹性伸缩, auto scaling), and any other Alibaba Cloud product. Also use when the user mentions \"aliyun\", \"阿里云\", \"阿里云CLI\", \"命令行\", asks about CLI plugin installation, encounters Aliyun CLI errors (InvalidAccessKeyId, SignatureDoesNotMatch, Throttling), or needs help constructing aliyun commands with correct parameter syntax.","irfanfaraaz\u002Fclaude-kit","irfanfaraaz","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F87533725?v=4","01M7E6ZGQPF7DTPAFQ4N695DBW","Syed Irfan Faraz","01M7E6ZGR6NERV5QMACPYC8GK2",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Firfanfaraaz\u002Fclaude-kit\u002Fblob\u002Fmain\u002Fskills\u002Falibabacloud-cli-guidance\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: alibabacloud-cli-guidance\ndescription: >\n  Guide users to manage Alibaba Cloud resources using the Aliyun CLI command-line tool.\n  Covers CLI installation, credential configuration, plugin management, command construction,\n  and error troubleshooting. Use this skill when the user wants to operate Alibaba Cloud\n  services from the terminal — including ECS (云服务器, cloud servers),\n  Function Compute (函数计算, serverless), RDS (云数据库, databases),\n  OSS (对象存储, object storage), SLS (日志服务, log service),\n  VPC (专有网络, networking), ESS (弹性伸缩, auto scaling),\n  and any other Alibaba Cloud product. Also use when the user mentions \"aliyun\", \"阿里云\",\n  \"阿里云CLI\", \"命令行\", asks about CLI plugin installation, encounters Aliyun CLI errors\n  (InvalidAccessKeyId, SignatureDoesNotMatch, Throttling), or needs help constructing\n  aliyun commands with correct parameter syntax.\nlicense: Apache-2.0\nmetadata:\n  domain: aliyun-cli\n  owner: sdk-team\n  contact: sdk-team@alibabacloud.com\nallowed-tools: Bash, aliyun cli\n---\n\n# Aliyun CLI Expert\n\nGuide users to manage Alibaba Cloud resources effectively using the `aliyun` command-line tool.\n\n**Required permissions** : see `.\u002Freferences\u002Fram-policies.md` (`## required_permissions`). Extend **on demand** for other CLI commands.\n\n## Instructions\n\n### Agent execution: AI-mode and User-Agent (this skill)\n\n**Skill identifier** (same string whichever path you use): `AlibabaCloud-Agent-Skills\u002Falibabacloud-cli-guidance`\n\nUse **exactly one** way to attach this skill to requests. **Do not combine** AI-mode (`configure ai-mode` + `set-user-agent`) with `ALIBABA_CLOUD_USER_AGENT` or a per-command env prefix for the **same** skill token — the CLI stacks those sources, and **User-Agent \u002F attribution will duplicate** (bad for telemetry).\n\n| Path | When to use | Start | End \u002F cleanup |\n| ---- | ----------- | ----- | ------------- |\n| **A — AI-mode (preferred for agents)** | Agent session, many `aliyun` calls | `aliyun configure ai-mode enable` then `aliyun configure ai-mode set-user-agent --user-agent \"AlibabaCloud-Agent-Skills\u002Falibabacloud-cli-guidance\"` | **[MUST]** `aliyun configure ai-mode disable` before the final response on **every** exit (success, failure, error, cancel, session end). **Do not** `export ALIBABA_CLOUD_USER_AGENT` to the same value while AI-mode is on. |\n| **B — Environment or one-shot** | One-off commands, scripts without `configure`, or no AI-mode | `export ALIBABA_CLOUD_USER_AGENT=AlibabaCloud-Agent-Skills\u002Falibabacloud-cli-guidance` for the session, **or** prefix each API call: `ALIBABA_CLOUD_USER_AGENT=AlibabaCloud-Agent-Skills\u002Falibabacloud-cli-guidance aliyun ...` | If you used **`export`**, run `unset ALIBABA_CLOUD_USER_AGENT` when done so other skills are not mis-attributed. Inline prefix needs no unset. **Do not** enable AI-mode on path B for the same skill string. |\n\nPath A — start (before the first `aliyun` that hits the API; local `aliyun configure` without cloud calls may run first if needed):\n\n```bash\naliyun configure ai-mode enable\naliyun configure ai-mode set-user-agent --user-agent \"AlibabaCloud-Agent-Skills\u002Falibabacloud-cli-guidance\"\n```\n\nPath A — **[MUST] disable at every exit** (AI-mode must not remain on after the skill stops):\n\n```bash\naliyun configure ai-mode disable\n```\n\nPath B — examples (one carrier per workflow: `export`, inline env, or root `--user-agent`; never stack the same token or mix with path A):\n\n```bash\nexport ALIBABA_CLOUD_USER_AGENT=AlibabaCloud-Agent-Skills\u002Falibabacloud-cli-guidance\n# … aliyun … calls … then: unset ALIBABA_CLOUD_USER_AGENT\n```\n\n```bash\nALIBABA_CLOUD_USER_AGENT=AlibabaCloud-Agent-Skills\u002Falibabacloud-cli-guidance aliyun ecs DescribeRegions\n```\n\nRoot **`--user-agent`** is path B semantics too — do not combine with path A for the same token. **Non-agent** copy-paste: path B is often enough; **agent** sessions: path A + disable on exit. Examples below use path A or B only, never both.\n\n**Pre-check: Aliyun CLI >= 3.3.3 required** — Run `aliyun version`. If too low: `curl -fsSL https:\u002F\u002Faliyuncli.alicdn.com\u002Fsetup.sh | bash` or see `references\u002Finstallation-guide.md`.\n\n**Pre-check: Aliyun CLI plugin update required** — [MUST] `aliyun configure set --auto-plugin-install true`; [MUST] `aliyun plugin update`.\n\n**CLI version milestones (agents and users)**\n\n| From version | What you gain |\n| ------------- | -------------- |\n| **>= 3.3.3** | Baseline for product plugins and flows in this skill (see pre-checks above). |\n| **>= 3.3.5** | **`aliyun upgrade`** — update the CLI from the binary itself when the subcommand exists. Prefer it over re-running the install script for routine upgrades once the CLI is new enough. |\n| **>= 3.3.8** | **`aliyun plugin show --name \u003Cplugin>`** — details for an **installed** plugin (version, product code, descriptions, API versions when present). On older CLIs, use `aliyun plugin list` and product `--help` only. |\n\n### 1. Install and configure the CLI\n\nIf the user hasn't installed or configured the CLI, guide them through setup.\nSee `.\u002Freferences\u002Finstallation-guide.md` for full details. Quick path:\n\n```bash\n# Install or update (macOS \u002F Linux — one command)\n\u002Fbin\u002Fbash -c \"$(curl -fsSL --connect-timeout 10 --max-time 120 https:\u002F\u002Faliyuncli.alicdn.com\u002Fsetup.sh)\"\n```\n\nAfter the CLI is at **3.3.5 or newer**, routine self-updates can use **`aliyun upgrade`** instead of the curl installer (the installer remains appropriate for first-time install or when `upgrade` is not available):\n\n```bash\naliyun version   # confirm >= 3.3.5 before relying on upgrade\naliyun upgrade\n```\n\n#### OAuth (browser login)\n\nWhen a **browser can be opened** on the same machine (for example a local desktop with a GUI), **prefer OAuth** over storing AccessKey pairs: credentials are not kept as plaintext AK\u002FSecretKey in configuration, and sign-in can use SSO. Requires Alibaba Cloud CLI **3.0.299** or later. **Not** suitable for headless environments (for example SSH-only servers without a local browser).\n\nRun interactively:\n\n```bash\naliyun configure --profile \u003Cyour-profile-name> --mode OAuth\n```\n\nFull setup (administrator consent, RAM identity assignments, `CN` vs `INTL` site) is documented in [Configure OAuth authentication for Alibaba Cloud CLI](https:\u002F\u002Fwww.alibabacloud.com\u002Fhelp\u002Fen\u002Fdoc-detail\u002F2995960.html) and `.\u002Freferences\u002Finstallation-guide.md`.\n\n```bash\n# Credentials via environment variables (automation, CI\u002FCD, headless, or when OAuth is not available)\nexport ALIBABA_CLOUD_ACCESS_KEY_ID=\u003Ckey-id>\nexport ALIBABA_CLOUD_ACCESS_KEY_SECRET=\u003Ckey-secret>\nexport ALIBABA_CLOUD_REGION_ID=cn-hangzhou\n# Temporary credentials (StsToken) — add:\n# export ALIBABA_CLOUD_SECURITY_TOKEN=\u003Csts-token>\n\n# API calls + this skill: use path A (ai-mode) OR path B (ALIBABA_CLOUD_USER_AGENT) — not both — see \"Agent execution: AI-mode and User-Agent (this skill)\"\n\n# Verify\naliyun version      # Should be >= 3.3.3\naliyun ecs describe-regions   # Tests authentication\n```\n\nAliyun CLI 3.3.3+ supports all published Alibaba Cloud product plugins. Newer commands (`aliyun upgrade` from **3.3.5**, `aliyun plugin show` from **3.3.8**) are summarized under **CLI version milestones** near the top of these instructions.\n\n#### Authentication modes (environment variables)\n\nFor modes that use **explicit keys or tokens** (not OAuth), choose what fits the deployment context. When set, these environment variables override any values in `~\u002F.aliyun\u002Fconfig.json`.\n\n| Mode | When to use | Environment variables |\n| ---- | ----------- | --------------------- |\n| **AK** | Development, long-lived credentials | `ALIBABA_CLOUD_ACCESS_KEY_ID`, `ALIBABA_CLOUD_ACCESS_KEY_SECRET`, `ALIBABA_CLOUD_REGION_ID` |\n| **StsToken** | CI\u002FCD, temporary credentials | Same as AK, plus `ALIBABA_CLOUD_SECURITY_TOKEN` |\n| **RamRoleArn** | After AssumeRole or cross-account session | Export the temporary pair from the role session: same variables as **StsToken** (AK + secret + `ALIBABA_CLOUD_SECURITY_TOKEN`) |\n\n#### Multiple accounts or environments\n\nUse separate `export` blocks per shell session, CI job, or secret store (different `ALIBABA_CLOUD_ACCESS_KEY_ID` \u002F `ALIBABA_CLOUD_ACCESS_KEY_SECRET` \u002F `ALIBABA_CLOUD_REGION_ID` values). For profile-based workflows backed by the config file, see `.\u002Freferences\u002Finstallation-guide.md`.\n\n### 2. Consult `--help` before constructing any command\n\nBuilt-in commands have inconsistent parameter naming across APIs — some use PascalCase,\nothers camelCase, and the exact names are not predictable. Guessing parameter names frequently\nleads to errors that require multiple retries. Running `--help` first takes seconds:\n\n```bash\naliyun \u003Cproduct> --help                # Discover available subcommands\naliyun \u003Cproduct> \u003Csubcommand> --help   # Get exact parameter names, types, structure\n```\n\nHelp output is the authoritative source. Plugin help is especially rich — it includes type\ninfo, structure fields, format hints, and constraints for every parameter.\n\nWhen a plugin is installed, `aliyun \u003Cproduct> --help` automatically shows plugin help. To view\nthe legacy built-in (OpenAPI-style) help instead:\n\n```bash\nALIBABA_CLOUD_ORIGINAL_PRODUCT_HELP=true aliyun ecs --help\n```\n\n### 3. Ensure service plugins are available\n\nEach Alibaba Cloud product has a CLI plugin. Plugins provide consistent kebab-case commands\nwith comprehensive help, while the legacy built-in system has inconsistent naming and minimal\nhelp. If you know which product to use, install the plugin directly — `plugin install` is\nidempotent (safe to run even if already installed):\n\n```bash\naliyun plugin install --names ecs     # Install (short name, case-insensitive)\naliyun plugin install --names ECS VPC RDS   # Multiple at once\n```\n\nTo discover or verify plugins:\n\n```bash\naliyun plugin list                    # Installed plugins\naliyun plugin list-remote             # All available plugins\naliyun plugin search \u003Ckeyword>        # Search by keyword\naliyun plugin show --name ecs         # Aliyun CLI >= 3.3.8 — details for one installed plugin\n```\n\n`plugin show` requires **Aliyun CLI >= 3.3.8** and only works for **installed** plugins (use `plugin list-remote` \u002F `plugin search` to inspect the catalog). On older versions, omit `plugin show` and rely on `plugin list` plus `aliyun \u003Cproduct> --help`.\n\nPlugin names accept both short form (`ecs`) and full form (`aliyun-cli-ecs`), case-insensitive.\n\nPlugin lifecycle:\n\n```bash\naliyun plugin update --name ecs              # Update a plugin\naliyun plugin uninstall --name ecs           # Remove a plugin\n```\n\n### 4. Prefer plugin commands over built-in commands\n\nThe CLI has two command styles, and the **subcommand casing** determines which system handles it:\n\n- **All-lowercase subcommand** → routed to plugin (CLI Native style)\n- **Contains uppercase** → routed to built-in (OpenAPI style)\n\nPlugin commands use consistent kebab-case naming for both subcommands and parameters, making\nthem predictable. Built-in commands use PascalCase subcommands with mixed\u002Finconsistent parameter\nnaming that varies by API — you must check `--help` for every command to know the exact names.\n\n```bash\n# Plugin (preferred): consistent kebab-case\naliyun ecs describe-instances --biz-region-id cn-hangzhou\n\n# Built-in (fallback): PascalCase subcommand, inconsistent params\naliyun ecs DescribeInstances --RegionId cn-hangzhou\n```\n\nMixing styles causes silent failures — the CLI routes to different backends based on subcommand\ncasing. A kebab-case subcommand with PascalCase parameters will be sent to the plugin system,\nwhich doesn't recognize PascalCase parameter names.\n\nProduct code is always case-insensitive (`ecs`, `Ecs`, `ECS` all work).\n\n| Aspect | Plugin (CLI Native) | Built-in (OpenAPI) |\n| ------ | ------------------- | ------------------ |\n| Subcommand | `describe-instances` | `DescribeInstances` |\n| Parameters | kebab-case (consistent) | Mixed (inconsistent) |\n| ROA Body | Expanded to individual params | Single `--body` JSON |\n| Header params | Visible in help, usable directly | Hidden, manual `--header` only |\n| Help | Comprehensive with structure | Basic |\n\n### 5. Understand global vs business parameter naming\n\nThe CLI plugin system reserves certain global parameters for its own use:\n\n- `--region-id` \u002F `--region` — controls which **API endpoint** the request is sent to (e.g.\n  `ecs.cn-hangzhou.aliyuncs.com`). This is a routing concern, not a business field.\n- Other globals include `--profile`, `--api-version`, `--output`, etc.\n\nMany APIs also define their own `RegionId` or `Region` parameter in the API spec — these are\n**business parameters** with API-specific meaning (e.g. \"the region to create this resource in\").\nThe global `--region-id` and the API's `RegionId` serve different purposes, but they would\ncollide on the command line.\n\nThe plugin system resolves this automatically during code generation:\n\n1. **`--biz-` prefix (default)**: the API parameter `RegionId` becomes `--biz-region-id`\n2. **`--\u003Cproduct>-` prefix (fallback)**: if `--biz-region-id` is already taken by another\n   parameter, the plugin falls back to `--\u003Cproduct>-region-id` (e.g. `--ecs-region-id`)\n\nThis means in plugin commands, `--region-id` is **always** the global endpoint selector, and\nthe business region is `--biz-region-id` (or `--\u003Cproduct>-region-id`). Using `--region-id` where\nyou meant the business parameter silently changes the endpoint without setting the intended field.\n\nAlways check `--help` to see the actual parameter name — it is the authoritative source for\nwhether a given command uses `--biz-region-id`, `--\u003Cproduct>-region-id`, or something else.\n\n### 6. Use structured parameter syntax\n\nPlugins support structured input that the framework serializes automatically. This avoids\nthe error-prone legacy `--Tag.N.Key` \u002F `--Param.N=value` syntax.\n\n**Primitives and lists:**\n\n```bash\n--instance-id i-abc123                                  # single value\n--security-group-ids sg-001 sg-002 sg-003               # space-separated list\n--instance-id i-abc --instance-id i-def                 # repeated param (also valid)\n```\n\n**Key-value objects and repeatable structures:**\n\n```bash\n--tag Key=env Value=prod --tag Key=app Value=web        # repeatable key-value\n--capacity-options OnDemandBaseCapacity=12 CompensateWithOnDemand=true  # object\n--data-disk '{\"DiskName\":\"d1\",\"Size\":100}'              # complex structure (JSON)\n```\n\nCheck `--help` for each command — it shows the exact type, structure fields, and whether a\nparameter is repeatable.\n\n### 7. OSS uses custom commands\n\nUnlike other products, OSS has a hand-written implementation with custom command syntax.\nAPI-style commands like `PutBucket` or `GetObject` do not exist for OSS — using them will fail\nsilently or produce confusing errors. Always check help first:\n\n```bash\naliyun oss --help        # Basic operations (cp, ls, mb, rm, etc.)\naliyun ossutil --help    # Advanced utilities (sync, stat, etc.)\n```\n\nThe lines below are **syntax examples only** (`\u003Cyour-*>` placeholders). **Do not run them verbatim** — substitute real paths, bucket names, and file names before executing.\n\n```bash\naliyun oss cp \u003Cyour-file-name>.txt oss:\u002F\u002F\u003Cyour-bucket-name>\u002F      # Upload\naliyun oss mb oss:\u002F\u002F\u003Cyour-bucket-name>              # Create bucket\naliyun ossutil sync .\u002F\u003Cyour-folder-name>\u002F oss:\u002F\u002F\u003Cyour-bucket-name>\u002F # Sync directory\n```\n\n### 8. Filter and format output\n\nUse `--cli-query` (JMESPath) to extract specific fields from API responses, and `--output`\nto control the format. This avoids piping large JSON blobs through external tools:\n\n```bash\n# JMESPath filter: only running instances, selected fields\naliyun ecs describe-instances \\\n  --biz-region-id cn-hangzhou \\\n  --cli-query \"Instances.Instance[?Status=='Running'].{ID:InstanceId,Name:InstanceName}\"\n\n# Output formats\naliyun ecs describe-instances --biz-region-id cn-hangzhou --output json              # default\naliyun ecs describe-instances --biz-region-id cn-hangzhou --output table             # human-readable table\naliyun ecs describe-instances --biz-region-id cn-hangzhou --output cols=InstanceId,InstanceName,Status rows=\"Instances.Instance[]\"  # custom columns\n```\n\n### 9. Pagination\n\nMany list commands return paginated results. Use `--page-number` and `--page-size` to control:\n\n```bash\naliyun ecs describe-instances \\\n  --biz-region-id cn-hangzhou \\\n  --page-number 1 \\\n  --page-size 50\n```\n\nTo fetch all pages automatically without manual loops, use `--pager`:\n\n```bash\naliyun ecs describe-instances \\\n  --biz-region-id cn-hangzhou \\\n  --pager path='Instances.Instance[]' PageNumber=PageNumber PageSize=PageSize\n```\n\nThe `path` argument specifies which JSON field contains the page data to merge.\n\n### 10. Wait for resource state\n\nSome commands support built-in waiters for automation — poll until a resource reaches the desired state:\n\n```bash\naliyun vpc describe-vpc-attribute \\\n  --biz-region-id cn-shanghai \\\n  --vpc-id \u003Cyour-vpc-id> \\\n  --waiter expr='Status' to='Available'\n```\n\n### 11. Debugging\n\nWhen troubleshooting command failures, these flags reveal what's happening under the hood — the full HTTP request\u002Fresponse and parameter validation details:\n\n- `--log-level debug` — detailed request\u002Fresponse logs (shows endpoint, serialized params, response)\n- `--cli-dry-run` — validate command without executing (checks parameter parsing)\n- `ALIBABA_CLOUD_CLI_LOG_CONFIG=debug` — environment variable to set log level globally\n\nFor **403**, **Forbidden**, **NoPermission**, or other RAM-style denials, the identity behind the credentials lacks permission for the underlying API action. See `.\u002Freferences\u002Fram-policies.md` for the skill’s `required_permissions` table, on-demand authorization, and how to narrow permissions.\n\n### 12. Multi-version API support\n\nSome products (e.g. ESS, SLB) ship multiple API versions with different command sets and\ncapabilities. Using the wrong version may cause missing parameters, deprecated behavior, or\nentirely different command availability. Not all products have multiple versions — if\n`list-api-versions` returns an error, the product is single-version and no action is needed.\n\n#### Discover versions\n\n```bash\naliyun \u003Cproduct> list-api-versions\n```\n\nExample (ESS; `*` = default):\n\n```text\n* 2014-08-28 (default)\n  2022-02-22\n```\n\nEach version may expose different commands or parameter names.\n\n#### Specify version per command\n\n```bash\naliyun ess describe-scaling-groups --api-version 2022-02-22 --biz-region-id cn-hangzhou\n```\n\n#### Set a default version via environment variable\n\nTo avoid passing `--api-version` on every call, set the default for a product:\n\n```bash\nexport ALIBABA_CLOUD_ESS_API_VERSION=2022-02-22\nexport ALIBABA_CLOUD_SLB_API_VERSION=2014-05-15\n```\n\nThe pattern is `ALIBABA_CLOUD_\u003CPRODUCT_CODE>_API_VERSION` (product code in uppercase).\nThis is especially useful in scripts or CI\u002FCD where you want consistent version behavior\nacross multiple commands.\n\n#### View commands for a specific version\n\nDifferent API versions may have different command sets. To see what's available:\n\n```bash\naliyun ess --api-version 2022-02-22    # List commands in this version\naliyun ess \u003Ccmd> --api-version 2022-02-22 --help   # Help for a specific command in this version\n```\n\n#### When to specify version\n\n- **Default** — enough unless you need newer features.\n- **`--help`** — missing parameter may exist only in another API version.\n- **Scripts \u002F CI** — pin `ALIBABA_CLOUD_\u003CPRODUCT>_API_VERSION` for reproducibility.\n\n## Global Flags Reference\n\nThese flags are available on all plugin commands:\n\n| Flag | Purpose |\n| ---- | ------- |\n| `--region \u003Cregion>` | API endpoint region (global, not business region) |\n| `--profile \u003Cname>` | Use a named credential profile |\n| `--api-version \u003Cver>` | Override API version for this command |\n| `--output json\\|table\\|cols=...` | Response format |\n| `--cli-query \u003Cjmespath>` | JMESPath filter on response |\n| `--log-level debug` | Verbose request\u002Fresponse logging |\n| `--cli-dry-run` | Validate without executing |\n| `--endpoint \u003Curl>` | Override service endpoint |\n| `--retry \u003Cn>` | Retry count for failed requests |\n| `--quiet` | Suppress output |\n| `--pager` | Auto-merge all pages for pageable APIs |\n\n## Common Workflows\n\n### ECS Instances\n\n```bash\naliyun plugin list | grep ecs\n# If missing: aliyun plugin install --names ecs\n\naliyun ecs describe-instances --biz-region-id cn-hangzhou\n```\n\nThe `create-instance` example below **provisions billable resources** (fixed image ID, instance type, and disk as illustration). **Do not run it verbatim** — adjust region, image, type, disks, network, and tags for your account and policies before executing.\n\n```bash\naliyun ecs create-instance \\\n  --biz-region-id cn-hangzhou \\\n  --instance-type ecs.g7.large \\\n  --image-id ubuntu_20_04_arm64_20G_alibase_20250625.vhd \\\n  --data-disk Category=cloud_essd Size=100 \\\n  --tag Key=env Value=prod --tag Key=app Value=web\n```\n\n### Function Compute (ROA Body Expansion)\n\n```bash\naliyun plugin list | grep fc\n# If missing: aliyun plugin install --names fc\n```\n\nThe block below is a **syntax example** (`\u003Cyour-function-name>` and other values are illustrative). **Do not run verbatim** — set the real function name, runtime, handler, memory, timeout, and add any required VPC or service role settings for your environment. Plugin commands expand ROA body fields into individual params (no `--body` JSON needed).\n\n```bash\naliyun fc create-function \\\n  --function-name \u003Cyour-function-name> \\\n  --runtime python3.9 \\\n  --handler index.handler \\\n  --memory-size 512 \\\n  --timeout 60 \\\n  --description \"Process uploaded images\"\n```\n\n### Multi-Version API (ESS)\n\n```bash\n# Check available versions\naliyun ess list-api-versions\n\n# Use the latest version for new features\nexport ALIBABA_CLOUD_ESS_API_VERSION=2022-02-22\naliyun ess describe-scaling-groups --biz-region-id cn-hangzhou\n\n# Or specify per command without env var\naliyun ess describe-scaling-groups --api-version 2022-02-22 --biz-region-id cn-hangzhou\n```\n\n## Response Format\n\nWhen providing CLI commands:\n\n1. Explain what the command does and why specific parameters are used\n2. Show the complete command with all required parameters\n3. Call out non-obvious values — especially `--biz-` prefixed parameters and their reason\n4. Suggest `--log-level debug` when the user is troubleshooting\n5. For API attribution, use **either** AI-mode + `set-user-agent` **or** env\u002Finline `ALIBABA_CLOUD_USER_AGENT`, never both for the same skill token; agents should disable AI-mode on every exit or `unset` after `export` (see **Agent execution: AI-mode and User-Agent (this skill)**)\n\n## References\n\n- `.\u002Freferences\u002Finstallation-guide.md` — Installation, configuration modes, credential setup\n- `.\u002Freferences\u002Fcommand-syntax.md` — Complete command syntax guide\n- `.\u002Freferences\u002Fglobal-flags.md` — Global flags reference\n- `.\u002Freferences\u002Fram-policies.md` — On-demand RAM, least privilege, common permission errors\n","# Aliyun CLI Expert\n\nGuide users to manage Alibaba Cloud resources effectively using the `aliyun` command-line tool.\n\n**Required permissions** : see `.\u002Freferences\u002Fram-policies.md` (`## required_permissions`). Extend **on demand** for other CLI commands.\n\n## Instructions\n\n### Agent execution: AI-mode and User-Agent (this skill)\n\n**Skill identifier** (same string whichever path you use): `AlibabaCloud-Agent-Skills\u002Falibabacloud-cli-guidance`\n\nUse **exactly one** way to attach this skill to requests. **Do not combine** AI-mode (`configure ai-mode` + `set-user-agent`) with `ALIBABA_CLOUD_USER_AGENT` or a per-command env prefix for the **same** skill token — the CLI stacks those sources, and **User-Agent \u002F attribution will duplicate** (bad for telemetry).\n\n| Path | When to use | Start | End \u002F cleanup |\n| ---- | ----------- | ----- | ------------- |\n| **A — AI-mode (preferred for agents)** | Agent session, many `aliyun` calls | `aliyun configure ai-mode enable` then `aliyun configure ai-mode set-user-agent --user-agent \"AlibabaCloud-Agent-Skills\u002Falibabacloud-cli-guidance\"` | **[MUST]** `aliyun configure ai-mode disable` before the final response on **every** exit (success, failure, error, cancel, session end). **Do not** `export ALIBABA_CLOUD_USER_AGENT` to the same value while AI-mode is on. |\n| **B — Environment or one-shot** | One-off commands, scripts without `configure`, or no AI-mode | `export ALIBABA_CLOUD_USER_AGENT=AlibabaCloud-Agent-Skills\u002Falibabacloud-cli-guidance` for the session, **or** prefix each API call: `ALIBABA_CLOUD_USER_AGENT=AlibabaCloud-Agent-Skills\u002Falibabacloud-cli-guidance aliyun ...` | If you used **`export`**, run `unset ALIBABA_CLOUD_USER_AGENT` when done so other skills are not mis-attributed. Inline prefix needs no unset. **Do not** enable AI-mode on path B for the same skill string. |\n\nPath A — start (before the first `aliyun` that hits the API; local `aliyun configure` without cloud calls may run first if needed):\n\n```bash\naliyun configure ai-mode enable\naliyun configure ai-mode set-user-agent --user-agent \"AlibabaCloud-Agent-Skills\u002Falibabacloud-cli-guidance\"\n```\n\nPath A — **[MUST] disable at every exit** (AI-mode must not remain on after the skill stops):\n\n```bash\naliyun configure ai-mode disable\n```\n\nPath B — examples (one carrier per workflow: `export`, inline env, or root `--user-agent`; never stack the same token or mix with path A):\n\n```bash\nexport ALIBABA_CLOUD_USER_AGENT=AlibabaCloud-Agent-Skills\u002Falibabacloud-cli-guidance\n# … aliyun … calls … then: unset ALIBABA_CLOUD_USER_AGENT\n```\n\n```bash\nALIBABA_CLOUD_USER_AGENT=AlibabaCloud-Agent-Skills\u002Falibabacloud-cli-guidance aliyun ecs DescribeRegions\n```\n\nRoot **`--user-agent`** is path B semantics too — do not combine with path A for the same token. **Non-agent** copy-paste: path B is often enough; **agent** sessions: path A + disable on exit. Examples below use path A or B only, never both.\n\n**Pre-check: Aliyun CLI >= 3.3.3 required** — Run `aliyun version`. If too low: `curl -fsSL https:\u002F\u002Faliyuncli.alicdn.com\u002Fsetup.sh | bash` or see `references\u002Finstallation-guide.md`.\n\n**Pre-check: Aliyun CLI plugin update required** — [MUST] `aliyun configure set --auto-plugin-install true`; [MUST] `aliyun plugin update`.\n\n**CLI version milestones (agents and users)**\n\n| From version | What you gain |\n| ------------- | -------------- |\n| **>= 3.3.3** | Baseline for product plugins and flows in this skill (see pre-checks above). |\n| **>= 3.3.5** | **`aliyun upgrade`** — update the CLI from the binary itself when the subcommand exists. Prefer it over re-running the install script for routine upgrades once the CLI is new enough. |\n| **>= 3.3.8** | **`aliyun plugin show --name \u003Cplugin>`** — details for an **installed** plugin (version, product code, descriptions, API versions when present). On older CLIs, use `aliyun plugin list` and product `--help` only. |\n\n### 1. Install and configure the CLI\n\nIf the user hasn't installed or configured the CLI, guide them through setup.\nSee `.\u002Freferences\u002Finstallation-guide.md` for full details. Quick path:\n\n```bash\n# Install or update (macOS \u002F Linux — one command)\n\u002Fbin\u002Fbash -c \"$(curl -fsSL --connect-timeout 10 --max-time 120 https:\u002F\u002Faliyuncli.alicdn.com\u002Fsetup.sh)\"\n```\n\nAfter the CLI is at **3.3.5 or newer**, routine self-updates can use **`aliyun upgrade`** instead of the curl installer (the installer remains appropriate for first-time install or when `upgrade` is not available):\n\n```bash\naliyun version   # confirm >= 3.3.5 before relying on upgrade\naliyun upgrade\n```\n\n#### OAuth (browser login)\n\nWhen a **browser can be opened** on the same machine (for example a local desktop with a GUI), **prefer OAuth** over storing AccessKey pairs: credentials are not kept as plaintext AK\u002FSecretKey in configuration, and sign-in can use SSO. Requires Alibaba Cloud CLI **3.0.299** or later. **Not** suitable for headless environments (for example SSH-only servers without a local browser).\n\nRun interactively:\n\n```bash\naliyun configure --profile \u003Cyour-profile-name> --mode OAuth\n```\n\nFull setup (administrator consent, RAM identity assignments, `CN` vs `INTL` site) is documented in [Configure OAuth authentication for Alibaba Cloud CLI](https:\u002F\u002Fwww.alibabacloud.com\u002Fhelp\u002Fen\u002Fdoc-detail\u002F2995960.html) and `.\u002Freferences\u002Finstallation-guide.md`.\n\n```bash\n# Credentials via environment variables (automation, CI\u002FCD, headless, or when OAuth is not available)\nexport ALIBABA_CLOUD_ACCESS_KEY_ID=\u003Ckey-id>\nexport ALIBABA_CLOUD_ACCESS_KEY_SECRET=\u003Ckey-secret>\nexport ALIBABA_CLOUD_REGION_ID=cn-hangzhou\n# Temporary credentials (StsToken) — add:\n# export ALIBABA_CLOUD_SECURITY_TOKEN=\u003Csts-token>\n\n# API calls + this skill: use path A (ai-mode) OR path B (ALIBABA_CLOUD_USER_AGENT) — not both — see \"Agent execution: AI-mode and User-Agent (this skill)\"\n\n# Verify\naliyun version      # Should be >= 3.3.3\naliyun ecs describe-regions   # Tests authentication\n```\n\nAliyun CLI 3.3.3+ supports all published Alibaba Cloud product plugins. Newer commands (`aliyun upgrade` from **3.3.5**, `aliyun plugin show` from **3.3.8**) are summarized under **CLI version milestones** near the top of these instructions.\n\n#### Authentication modes (environment variables)\n\nFor modes that use **explicit keys or tokens** (not OAuth), choose what fits the deployment context. When set, these environment variables override any values in `~\u002F.aliyun\u002Fconfig.json`.\n\n| Mode | When to use | Environment variables |\n| ---- | ----------- | --------------------- |\n| **AK** | Development, long-lived credentials | `ALIBABA_CLOUD_ACCESS_KEY_ID`, `ALIBABA_CLOUD_ACCESS_KEY_SECRET`, `ALIBABA_CLOUD_REGION_ID` |\n| **StsToken** | CI\u002FCD, temporary credentials | Same as AK, plus `ALIBABA_CLOUD_SECURITY_TOKEN` |\n| **RamRoleArn** | After AssumeRole or cross-account session | Export the temporary pair from the role session: same variables as **StsToken** (AK + secret + `ALIBABA_CLOUD_SECURITY_TOKEN`) |\n\n#### Multiple accounts or environments\n\nUse separate `export` blocks per shell session, CI job, or secret store (different `ALIBABA_CLOUD_ACCESS_KEY_ID` \u002F `ALIBABA_CLOUD_ACCESS_KEY_SECRET` \u002F `ALIBABA_CLOUD_REGION_ID` values). For profile-based workflows backed by the config file, see `.\u002Freferences\u002Finstallation-guide.md`.\n\n### 2. Consult `--help` before constructing any command\n\nBuilt-in commands have inconsistent parameter naming across APIs — some use PascalCase,\nothers camelCase, and the exact names are not predictable. Guessing parameter names frequently\nleads to errors that require multiple retries. Running `--help` first takes seconds:\n\n```bash\naliyun \u003Cproduct> --help                # Discover available subcommands\naliyun \u003Cproduct> \u003Csubcommand> --help   # Get exact parameter names, types, structure\n```\n\nHelp output is the authoritative source. Plugin help is especially rich — it includes type\ninfo, structure fields, format hints, and constraints for every parameter.\n\nWhen a plugin is installed, `aliyun \u003Cproduct> --help` automatically shows plugin help. To view\nthe legacy built-in (OpenAPI-style) help instead:\n\n```bash\nALIBABA_CLOUD_ORIGINAL_PRODUCT_HELP=true aliyun ecs --help\n```\n\n### 3. Ensure service plugins are available\n\nEach Alibaba Cloud product has a CLI plugin. Plugins provide consistent kebab-case commands\nwith comprehensive help, while the legacy built-in system has inconsistent naming and minimal\nhelp. If you know which product to use, install the plugin directly — `plugin install` is\nidempotent (safe to run even if already installed):\n\n```bash\naliyun plugin install --names ecs     # Install (short name, case-insensitive)\naliyun plugin install --names ECS VPC RDS   # Multiple at once\n```\n\nTo discover or verify plugins:\n\n```bash\naliyun plugin list                    # Installed plugins\naliyun plugin list-remote             # All available plugins\naliyun plugin search \u003Ckeyword>        # Search by keyword\naliyun plugin show --name ecs         # Aliyun CLI >= 3.3.8 — details for one installed plugin\n```\n\n`plugin show` requires **Aliyun CLI >= 3.3.8** and only works for **installed** plugins (use `plugin list-remote` \u002F `plugin search` to inspect the catalog). On older versions, omit `plugin show` and rely on `plugin list` plus `aliyun \u003Cproduct> --help`.\n\nPlugin names accept both short form (`ecs`) and full form (`aliyun-cli-ecs`), case-insensitive.\n\nPlugin lifecycle:\n\n```bash\naliyun plugin update --name ecs              # Update a plugin\naliyun plugin uninstall --name ecs           # Remove a plugin\n```\n\n### 4. Prefer plugin commands over built-in commands\n\nThe CLI has two command styles, and the **subcommand casing** determines which system handles it:\n\n- **All-lowercase subcommand** → routed to plugin (CLI Native style)\n- **Contains uppercase** → routed to built-in (OpenAPI style)\n\nPlugin commands use consistent kebab-case naming for both subcommands and parameters, making\nthem predictable. Built-in commands use PascalCase subcommands with mixed\u002Finconsistent parameter\nnaming that varies by API — you must check `--help` for every command to know the exact names.\n\n```bash\n# Plugin (preferred): consistent kebab-case\naliyun ecs describe-instances --biz-region-id cn-hangzhou\n\n# Built-in (fallback): PascalCase subcommand, inconsistent params\naliyun ecs DescribeInstances --RegionId cn-hangzhou\n```\n\nMixing styles causes silent failures — the CLI routes to different backends based on subcommand\ncasing. A kebab-case subcommand with PascalCase parameters will be sent to the plugin system,\nwhich doesn't recognize PascalCase parameter names.\n\nProduct code is always case-insensitive (`ecs`, `Ecs`, `ECS` all work).\n\n| Aspect | Plugin (CLI Native) | Built-in (OpenAPI) |\n| ------ | ------------------- | ------------------ |\n| Subcommand | `describe-instances` | `DescribeInstances` |\n| Parameters | kebab-case (consistent) | Mixed (inconsistent) |\n| ROA Body | Expanded to individual params | Single `--body` JSON |\n| Header params | Visible in help, usable directly | Hidden, manual `--header` only |\n| Help | Comprehensive with structure | Basic |\n\n### 5. Understand global vs business parameter naming\n\nThe CLI plugin system reserves certain global parameters for its own use:\n\n- `--region-id` \u002F `--region` — controls which **API endpoint** the request is sent to (e.g.\n  `ecs.cn-hangzhou.aliyuncs.com`). This is a routing concern, not a business field.\n- Other globals include `--profile`, `--api-version`, `--output`, etc.\n\nMany APIs also define their own `RegionId` or `Region` parameter in the API spec — these are\n**business parameters** with API-specific meaning (e.g. \"the region to create this resource in\").\nThe global `--region-id` and the API's `RegionId` serve different purposes, but they would\ncollide on the command line.\n\nThe plugin system resolves this automatically during code generation:\n\n1. **`--biz-` prefix (default)**: the API parameter `RegionId` becomes `--biz-region-id`\n2. **`--\u003Cproduct>-` prefix (fallback)**: if `--biz-region-id` is already taken by another\n   parameter, the plugin falls back to `--\u003Cproduct>-region-id` (e.g. `--ecs-region-id`)\n\nThis means in plugin commands, `--region-id` is **always** the global endpoint selector, and\nthe business region is `--biz-region-id` (or `--\u003Cproduct>-region-id`). Using `--region-id` where\nyou meant the business parameter silently changes the endpoint without setting the intended field.\n\nAlways check `--help` to see the actual parameter name — it is the authoritative source for\nwhether a given command uses `--biz-region-id`, `--\u003Cproduct>-region-id`, or something else.\n\n### 6. Use structured parameter syntax\n\nPlugins support structured input that the framework serializes automatically. This avoids\nthe error-prone legacy `--Tag.N.Key` \u002F `--Param.N=value` syntax.\n\n**Primitives and lists:**\n\n```bash\n--instance-id i-abc123                                  # single value\n--security-group-ids sg-001 sg-002 sg-003               # space-separated list\n--instance-id i-abc --instance-id i-def                 # repeated param (also valid)\n```\n\n**Key-value objects and repeatable structures:**\n\n```bash\n--tag Key=env Value=prod --tag Key=app Value=web        # repeatable key-value\n--capacity-options OnDemandBaseCapacity=12 CompensateWithOnDemand=true  # object\n--data-disk '{\"DiskName\":\"d1\",\"Size\":100}'              # complex structure (JSON)\n```\n\nCheck `--help` for each command — it shows the exact type, structure fields, and whether a\nparameter is repeatable.\n\n### 7. OSS uses custom commands\n\nUnlike other products, OSS has a hand-written implementation with custom command syntax.\nAPI-style commands like `PutBucket` or `GetObject` do not exist for OSS — using them will fail\nsilently or produce confusing errors. Always check help first:\n\n```bash\naliyun oss --help        # Basic operations (cp, ls, mb, rm, etc.)\naliyun ossutil --help    # Advanced utilities (sync, stat, etc.)\n```\n\nThe lines below are **syntax examples only** (`\u003Cyour-*>` placeholders). **Do not run them verbatim** — substitute real paths, bucket names, and file names before executing.\n\n```bash\naliyun oss cp \u003Cyour-file-name>.txt oss:\u002F\u002F\u003Cyour-bucket-name>\u002F      # Upload\naliyun oss mb oss:\u002F\u002F\u003Cyour-bucket-name>              # Create bucket\naliyun ossutil sync .\u002F\u003Cyour-folder-name>\u002F oss:\u002F\u002F\u003Cyour-bucket-name>\u002F # Sync directory\n```\n\n### 8. Filter and format output\n\nUse `--cli-query` (JMESPath) to extract specific fields from API responses, and `--output`\nto control the format. This avoids piping large JSON blobs through external tools:\n\n```bash\n# JMESPath filter: only running instances, selected fields\naliyun ecs describe-instances \\\n  --biz-region-id cn-hangzhou \\\n  --cli-query \"Instances.Instance[?Status=='Running'].{ID:InstanceId,Name:InstanceName}\"\n\n# Output formats\naliyun ecs describe-instances --biz-region-id cn-hangzhou --output json              # default\naliyun ecs describe-instances --biz-region-id cn-hangzhou --output table             # human-readable table\naliyun ecs describe-instances --biz-region-id cn-hangzhou --output cols=InstanceId,InstanceName,Status rows=\"Instances.Instance[]\"  # custom columns\n```\n\n### 9. Pagination\n\nMany list commands return paginated results. Use `--page-number` and `--page-size` to control:\n\n```bash\naliyun ecs describe-instances \\\n  --biz-region-id cn-hangzhou \\\n  --page-number 1 \\\n  --page-size 50\n```\n\nTo fetch all pages automatically without manual loops, use `--pager`:\n\n```bash\naliyun ecs describe-instances \\\n  --biz-region-id cn-hangzhou \\\n  --pager path='Instances.Instance[]' PageNumber=PageNumber PageSize=PageSize\n```\n\nThe `path` argument specifies which JSON field contains the page data to merge.\n\n### 10. Wait for resource state\n\nSome commands support built-in waiters for automation — poll until a resource reaches the desired state:\n\n```bash\naliyun vpc describe-vpc-attribute \\\n  --biz-region-id cn-shanghai \\\n  --vpc-id \u003Cyour-vpc-id> \\\n  --waiter expr='Status' to='Available'\n```\n\n### 11. Debugging\n\nWhen troubleshooting command failures, these flags reveal what's happening under the hood — the full HTTP request\u002Fresponse and parameter validation details:\n\n- `--log-level debug` — detailed request\u002Fresponse logs (shows endpoint, serialized params, response)\n- `--cli-dry-run` — validate command without executing (checks parameter parsing)\n- `ALIBABA_CLOUD_CLI_LOG_CONFIG=debug` — environment variable to set log level globally\n\nFor **403**, **Forbidden**, **NoPermission**, or other RAM-style denials, the identity behind the credentials lacks permission for the underlying API action. See `.\u002Freferences\u002Fram-policies.md` for the skill’s `required_permissions` table, on-demand authorization, and how to narrow permissions.\n\n### 12. Multi-version API support\n\nSome products (e.g. ESS, SLB) ship multiple API versions with different command sets and\ncapabilities. Using the wrong version may cause missing parameters, deprecated behavior, or\nentirely different command availability. Not all products have multiple versions — if\n`list-api-versions` returns an error, the product is single-version and no action is needed.\n\n#### Discover versions\n\n```bash\naliyun \u003Cproduct> list-api-versions\n```\n\nExample (ESS; `*` = default):\n\n```text\n* 2014-08-28 (default)\n  2022-02-22\n```\n\nEach version may expose different commands or parameter names.\n\n#### Specify version per command\n\n```bash\naliyun ess describe-scaling-groups --api-version 2022-02-22 --biz-region-id cn-hangzhou\n```\n\n#### Set a default version via environment variable\n\nTo avoid passing `--api-version` on every call, set the default for a product:\n\n```bash\nexport ALIBABA_CLOUD_ESS_API_VERSION=2022-02-22\nexport ALIBABA_CLOUD_SLB_API_VERSION=2014-05-15\n```\n\nThe pattern is `ALIBABA_CLOUD_\u003CPRODUCT_CODE>_API_VERSION` (product code in uppercase).\nThis is especially useful in scripts or CI\u002FCD where you want consistent version behavior\nacross multiple commands.\n\n#### View commands for a specific version\n\nDifferent API versions may have different command sets. To see what's available:\n\n```bash\naliyun ess --api-version 2022-02-22    # List commands in this version\naliyun ess \u003Ccmd> --api-version 2022-02-22 --help   # Help for a specific command in this version\n```\n\n#### When to specify version\n\n- **Default** — enough unless you need newer features.\n- **`--help`** — missing parameter may exist only in another API version.\n- **Scripts \u002F CI** — pin `ALIBABA_CLOUD_\u003CPRODUCT>_API_VERSION` for reproducibility.\n\n## Global Flags Reference\n\nThese flags are available on all plugin commands:\n\n| Flag | Purpose |\n| ---- | ------- |\n| `--region \u003Cregion>` | API endpoint region (global, not business region) |\n| `--profile \u003Cname>` | Use a named credential profile |\n| `--api-version \u003Cver>` | Override API version for this command |\n| `--output json\\|table\\|cols=...` | Response format |\n| `--cli-query \u003Cjmespath>` | JMESPath filter on response |\n| `--log-level debug` | Verbose request\u002Fresponse logging |\n| `--cli-dry-run` | Validate without executing |\n| `--endpoint \u003Curl>` | Override service endpoint |\n| `--retry \u003Cn>` | Retry count for failed requests |\n| `--quiet` | Suppress output |\n| `--pager` | Auto-merge all pages for pageable APIs |\n\n## Common Workflows\n\n### ECS Instances\n\n```bash\naliyun plugin list | grep ecs\n# If missing: aliyun plugin install --names ecs\n\naliyun ecs describe-instances --biz-region-id cn-hangzhou\n```\n\nThe `create-instance` example below **provisions billable resources** (fixed image ID, instance type, and disk as illustration). **Do not run it verbatim** — adjust region, image, type, disks, network, and tags for your account and policies before executing.\n\n```bash\naliyun ecs create-instance \\\n  --biz-region-id cn-hangzhou \\\n  --instance-type ecs.g7.large \\\n  --image-id ubuntu_20_04_arm64_20G_alibase_20250625.vhd \\\n  --data-disk Category=cloud_essd Size=100 \\\n  --tag Key=env Value=prod --tag Key=app Value=web\n```\n\n### Function Compute (ROA Body Expansion)\n\n```bash\naliyun plugin list | grep fc\n# If missing: aliyun plugin install --names fc\n```\n\nThe block below is a **syntax example** (`\u003Cyour-function-name>` and other values are illustrative). **Do not run verbatim** — set the real function name, runtime, handler, memory, timeout, and add any required VPC or service role settings for your environment. Plugin commands expand ROA body fields into individual params (no `--body` JSON needed).\n\n```bash\naliyun fc create-function \\\n  --function-name \u003Cyour-function-name> \\\n  --runtime python3.9 \\\n  --handler index.handler \\\n  --memory-size 512 \\\n  --timeout 60 \\\n  --description \"Process uploaded images\"\n```\n\n### Multi-Version API (ESS)\n\n```bash\n# Check available versions\naliyun ess list-api-versions\n\n# Use the latest version for new features\nexport ALIBABA_CLOUD_ESS_API_VERSION=2022-02-22\naliyun ess describe-scaling-groups --biz-region-id cn-hangzhou\n\n# Or specify per command without env var\naliyun ess describe-scaling-groups --api-version 2022-02-22 --biz-region-id cn-hangzhou\n```\n\n## Response Format\n\nWhen providing CLI commands:\n\n1. Explain what the command does and why specific parameters are used\n2. Show the complete command with all required parameters\n3. Call out non-obvious values — especially `--biz-` prefixed parameters and their reason\n4. Suggest `--log-level debug` when the user is troubleshooting\n5. For API attribution, use **either** AI-mode + `set-user-agent` **or** env\u002Finline `ALIBABA_CLOUD_USER_AGENT`, never both for the same skill token; agents should disable AI-mode on every exit or `unset` after `export` (see **Agent execution: AI-mode and User-Agent (this skill)**)\n\n## References\n\n- `.\u002Freferences\u002Finstallation-guide.md` — Installation, configuration modes, credential setup\n- `.\u002Freferences\u002Fcommand-syntax.md` — Complete command syntax guide\n- `.\u002Freferences\u002Fglobal-flags.md` — Global flags reference\n- `.\u002Freferences\u002Fram-policies.md` — On-demand RAM, least privilege, common permission errors\n",{"name":5,"license":15,"metadata":24,"description":28,"allowed-tools":29},{"owner":25,"domain":26,"contact":27},"sdk-team","aliyun-cli","sdk-team@alibabacloud.com","Guide users to manage Alibaba Cloud resources using the Aliyun CLI command-line tool. Covers CLI installation, credential configuration, plugin management, command construction, and error troubleshooting. Use this skill when the user wants to operate Alibaba Cloud services from the terminal — including ECS (云服务器, cloud servers), Function Compute (函数计算, serverless), RDS (云数据库, databases), OSS (对象存储, object storage), SLS (日志服务, log service), VPC (专有网络, networking), ESS (弹性伸缩, auto scaling), and any other Alibaba Cloud product. Also use when the user mentions \"aliyun\", \"阿里云\", \"阿里云CLI\", \"命令行\", asks about CLI plugin installation, encounters Aliyun CLI errors (InvalidAccessKeyId, SignatureDoesNotMatch, Throttling), or needs help constructing aliyun commands with correct parameter syntax.\n","Bash, aliyun cli","main","3ae3bc0cf4ff6299a28a9721fecddc617cf23713","skills\u002Falibabacloud-cli-guidance","https:\u002F\u002Fgithub.com\u002Firfanfaraaz\u002Fclaude-kit","https:\u002F\u002Fgithub.com\u002Firfanfaraaz","irfanfaraaz.in","AI-native Software Engineer","2026-10-20 19:39:08",{"source":8,"skillName":5,"commands":39,"prompt":49,"zipAvailable":50},[40,43,46],{"tool":41,"command":42},"npx","npx skills add irfanfaraaz\u002Fclaude-kit --skill alibabacloud-cli-guidance",{"tool":44,"command":45},"bunx","bunx skills add irfanfaraaz\u002Fclaude-kit --skill alibabacloud-cli-guidance",{"tool":47,"command":48},"pnpm","pnpm dlx skills add irfanfaraaz\u002Fclaude-kit --skill alibabacloud-cli-guidance","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Firfanfaraaz\u002Fclaude-kit\u002Fblob\u002Fmain\u002Fskills\u002Falibabacloud-cli-guidance\u002FSKILL.md",true,[52,58,62,66],{"path":53,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":56,"sourceHtmlUrl":57},"references\u002Fcommand-syntax.md","REFERENCE","参考文档",2676,"https:\u002F\u002Fgithub.com\u002Firfanfaraaz\u002Fclaude-kit\u002Fblob\u002Fmain\u002Fskills\u002Falibabacloud-cli-guidance\u002Freferences\u002Fcommand-syntax.md",{"path":59,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":60,"sourceHtmlUrl":61},"references\u002Fglobal-flags.md",2673,"https:\u002F\u002Fgithub.com\u002Firfanfaraaz\u002Fclaude-kit\u002Fblob\u002Fmain\u002Fskills\u002Falibabacloud-cli-guidance\u002Freferences\u002Fglobal-flags.md",{"path":63,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":64,"sourceHtmlUrl":65},"references\u002Finstallation-guide.md",11826,"https:\u002F\u002Fgithub.com\u002Firfanfaraaz\u002Fclaude-kit\u002Fblob\u002Fmain\u002Fskills\u002Falibabacloud-cli-guidance\u002Freferences\u002Finstallation-guide.md",{"path":67,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":68,"sourceHtmlUrl":69},"references\u002Fram-policies.md",3789,"https:\u002F\u002Fgithub.com\u002Firfanfaraaz\u002Fclaude-kit\u002Fblob\u002Fmain\u002Fskills\u002Falibabacloud-cli-guidance\u002Freferences\u002Fram-policies.md",[71,79,87,96,103,110],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":75,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M7E86STEC48SA7NJPTKS52X6","webapp-testing","Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.","https:\u002F\u002Fgithub.com\u002Firfanfaraaz\u002Fclaude-kit\u002Fblob\u002Fmain\u002Fskills\u002Fwebapp-testing\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Firfanfaraaz\u002Fclaude-kit\u002Fblob\u002Fmain\u002Fskills\u002Fwebapp-testing\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":83,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7E86KJEDAHV8X8TAZVJGH20","web-artifacts-builder","Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn\u002Fui). Use for complex artifacts requiring state management, routing, or shadcn\u002Fui components - not for simple single-file HTML\u002FJSX artifacts.","https:\u002F\u002Fgithub.com\u002Firfanfaraaz\u002Fclaude-kit\u002Fblob\u002Fmain\u002Fskills\u002Fweb-artifacts-builder\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Firfanfaraaz\u002Fclaude-kit\u002Fblob\u002Fmain\u002Fskills\u002Fweb-artifacts-builder\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":91,"licenseFileUrl":92,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M7E85NJYTPHAFDTEEDX2YSHD","video-use","Edit any video by conversation. Transcribe, cut, color grade, generate overlay animations, burn subtitles — for talking heads, montages, tutorials, travel, interviews. No presets, no menus. Ask questions, confirm the plan, execute, iterate, persist. Production-correctness rules are hard; everything else is artistic freedom.","MIT","https:\u002F\u002Fgithub.com\u002Firfanfaraaz\u002Fclaude-kit\u002Fblob\u002Fmain\u002Fskills\u002Fvideo-use\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Firfanfaraaz\u002Fclaude-kit\u002Fblob\u002Fmain\u002Fskills\u002Fvideo-use\u002FSKILL.md",[],[],{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":91,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":19},"01M7E85B7TYMKMW2CTH86PENS7","vercel-react-native-skills","React Native and Expo best practices for building performant mobile apps. Use when building React Native components, optimizing list performance, implementing animations, or working with native modules. Triggers on tasks involving React Native, Expo, mobile performance, or native platform APIs.","https:\u002F\u002Fgithub.com\u002Firfanfaraaz\u002Fclaude-kit\u002Fblob\u002Fmain\u002Fskills\u002Fvercel-react-native-skills\u002FSKILL.md",[],[],{"skillNo":104,"name":105,"nameZh":6,"description":106,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":91,"licenseFileUrl":6,"sourceHtmlUrl":107,"categories":108,"keywords":109,"publishedAt":19},"01M7E847V548VFTH4TK2VQWAMC","threejs","Build 3D web apps with Three.js (WebGL\u002FWebGPU). Use for 3D scenes, animations, custom shaders, PBR materials, VR\u002FXR experiences, games, data visualizations, product configurators.","https:\u002F\u002Fgithub.com\u002Firfanfaraaz\u002Fclaude-kit\u002Fblob\u002Fmain\u002Fskills\u002Fthreejs\u002FSKILL.md",[],[],{"skillNo":111,"name":112,"nameZh":6,"description":113,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":91,"licenseFileUrl":114,"sourceHtmlUrl":115,"categories":116,"keywords":117,"publishedAt":19},"01M7E83TBAQ8K371G1NS0NFXQA","threads-carousel","Convert text posts into visual carousel images or presentations for Threads, Instagram, LinkedIn, TikTok, YouTube. 12 slide types (incl. image\u002Femoji\u002Fnumber), 6 format presets (incl. 1920×1080 wide), 8 background styles (incl. ruled paper), 3-axis style system (font × color × purpose), highlighted keywords with optional italic-box style. Generates PNG or single-file PDF via Next.js preview + browser export. RU\u002FEN toolbar. Triggers: threads carousel, instagram carousel, linkedin carousel, tiktok carousel, карусель, slides, carousel images, presentation deck, presentation pdf.","https:\u002F\u002Fgithub.com\u002Firfanfaraaz\u002Fclaude-kit\u002Fblob\u002Fmain\u002Fskills\u002Fthreads-carousel\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Firfanfaraaz\u002Fclaude-kit\u002Fblob\u002Fmain\u002Fskills\u002Fthreads-carousel\u002FSKILL.md",[],[]]