alibabacloud-cli-guidance

name	alibabacloud-cli-guidance
description	Guide for Alibaba Cloud CLI (aliyun) command syntax, plugin system, parameter naming, and best practices. Use this skill to generate correct CLI commands, understand plugin vs built-in command differences, structured parameter syntax, output filtering, pagination, and error troubleshooting. This skill is a CLI knowledge reference — when MCP tools (AlibabaCloud___CallCLI, etc.) are available, always prefer MCP tools for execution rather than running aliyun commands locally in the shell.
triggers	aliyun CLI, Aliyun CLI, CLI command, CLI command, aliyun command, command-line tool, CLI plugin, plugin install, CLI install, CLI configuration, CLI error, CLI error, InvalidAccessKeyId, SignatureDoesNotMatch, Throttling, biz-region-id, kebab-case, plugin command, CLI syntax, command syntax, aliyun plugin, generate CLI command, generate CLI command, CLI parameter, CLI parameter
license	Apache-2.0
metadata	{"domain":"aliyun-cli","owner":"sdk-team","contact":"[e-mail]"}
source	alibabacloud-ecs-ops
allowed-tools	mcp__plugin_alibabacloud-core_alibabacloud-core__AlibabaCloud___CallCLI,mcp__plugin_alibabacloud-core_alibabacloud-core__AlibabaCloud___SearchApis,mcp__plugin_alibabacloud-core_alibabacloud-core__AlibabaCloud___GetApiDefinition,mcp__plugin_alibabacloud-core_alibabacloud-core__AlibabaCloud___GenerateCLICommand,mcp__plugin_alibabacloud-core_alibabacloud-core__AlibabaCloud___ListApis,mcp__plugin_alibabacloud-core_alibabacloud-core__AlibabaCloud___ListProducts

Aliyun CLI Expert

Guide for managing Alibaba Cloud resources using the aliyun command-line tool.

MCP Tools vs Local CLI Execution

IMPORTANT: This skill provides CLI command knowledge and syntax guidance. It does NOT mean you should always run aliyun commands locally in the shell.

Execution priority:

1. MCP tools (highest priority) — When AlibabaCloud___CallCLI and other MCP tools are available, always use them for API execution. MCP tools handle authentication, cross-account access (x_assume_account_id), and output filtering (x_output_jmespath_filter) without requiring local CLI installation or configuration.

2. Local CLI (fallback) — Only use local aliyun commands in the Bash tool when:

   • MCP tools are not available or not configured
   • The operation requires local file system access (e.g., aliyun oss cp, aliyun ossutil sync)
   • The user explicitly asks for a local CLI command to copy/paste or use in scripts
   • The user needs to install/configure the CLI itself

Use this skill's knowledge for:

• Understanding correct command syntax when calling AlibabaCloud___CallCLI
• Generating CLI commands via AlibabaCloud___GenerateCLICommand
• Knowing the difference between plugin-style and built-in-style commands
• Understanding parameter naming conventions (especially --biz- prefixes)
• Troubleshooting CLI errors returned by MCP or local execution
• Guiding users who want to run commands locally in their own terminals

Pivot to alibabacloud-find-skills when: the user's request reads as a solution pattern (batch ops, audits, rotations, scheduled cleanup, runbooks) or targets a product not covered by any in-plugin skill — a packaged official skill usually beats hand-rolled CLI sequences. See mcp-core-best-practices → Skill Discovery for the full trigger list.

Agent Execution: AI-mode and User-Agent

Only applicable when running aliyun commands locally (not via MCP tools).

Skill identifier: AlibabaCloud-Agent-Skills/alibabacloud-cli-guidance