Azure CLI – OpenClaw Skill

---

name: Azure CLI description: Comprehensive Azure Cloud Platform management via command-line interface license: MIT metadata: author: Dennis de Vaal d.devaal@gmail.com version: "1.0.0" keywords: "azure,cloud,infrastructure,devops,iac,management,scripting" repository: https://github.com/Azure/azure-cli compatibility:

• platform: macOS min_version: "10.12"
• platform: Linux min_version: "Ubuntu 18.04"
• platform: Windows min_version: "Windows 10"

---

Azure CLI Skill

Master the Azure command-line interface for cloud infrastructure management, automation, and DevOps workflows.

Azure CLI is Microsoft's powerful cross-platform command-line tool for managing Azure resources. This skill provides comprehensive knowledge of Azure CLI commands, authentication, resource management, and automation patterns.

What You'll Learn

Core Concepts

• Azure subscription and resource group architecture
• Authentication methods and credential management
• Resource Provider organization and registration
• Global parameters, output formatting, and query syntax
• Automation scripting and error handling

Major Service Areas (66 command modules)

• Compute: Virtual Machines, Scale Sets, Kubernetes (AKS), Containers
• Networking: Virtual Networks, Load Balancers, CDN, Traffic Manager
• Storage & Data: Storage Accounts, Data Lake, Cosmos DB, Databases
• Application Services: App Service, Functions, Container Apps
• Databases: SQL Server, MySQL, PostgreSQL, CosmosDB
• Integration & Messaging: Event Hubs, Service Bus, Logic Apps
• Monitoring & Management: Azure Monitor, Policy, RBAC, Cost Management
• AI & Machine Learning: Cognitive Services, Machine Learning
• DevOps: Azure DevOps, Pipelines, Extensions

Quick Start

Installation

macOS:

brew install azure-cli

Linux (Ubuntu/Debian):

curl -sL https://aka.ms/InstallAzureCliLinux | bash

Windows:

choco install azure-cli
# Or download MSI from https://aka.ms/InstallAzureCliWindowsMSI

Verify Installation:

az --version          # Show version
az --help             # Show general help

First Steps

# 1. Login to Azure (opens browser for authentication)
az login

# 2. View your subscriptions
az account list

# 3. Set default subscription (optional)
az account set --subscription "My Subscription"

# 4. Create a resource group
az group create -g myResourceGroup -l eastus

# 5. List your resource groups
az group list

Essential Commands

Authentication & Accounts

az login                                    # Interactive login
az login --service-principal -u APP_ID -p PASSWORD -t TENANT_ID
az login --identity                         # Managed identity
az logout                                   # Sign out
az account show                             # Current account
az account list                             # All accounts
az account set --subscription SUBSCRIPTION  # Set default

Global Flags (Use with Any Command)

--subscription ID       # Target subscription
--resource-group -g RG  # Target resource group
--output -o json|table|tsv|yaml  # Output format
--query JMESPATH_QUERY  # Filter/extract output
--verbose -v            # Verbose output
--debug                 # Debug mode
--help -h               # Command help

Resource Groups

az group list           # List all resource groups
az group create -g RG -l LOCATION  # Create
az group delete -g RG   # Delete
az group show -g RG     # Get details
az group update -g RG --tags key=value  # Update tags

Virtual Machines (Compute)

az vm create -g RG -n VM_NAME --image UbuntuLTS
az vm list -g RG
az vm show -g RG -n VM_NAME
az vm start -g RG -n VM_NAME
az vm stop -g RG -n VM_NAME
az vm restart -g RG -n VM_NAME
az vm delete -g RG -n VM_NAME

Storage Operations

az storage account create -g RG -n ACCOUNT --sku Standard_LRS
az storage account list
az storage container create --account-name ACCOUNT -n CONTAINER
az storage blob upload --account-name ACCOUNT -c CONTAINER -n BLOB -f LOCAL_FILE
az storage blob download --account-name ACCOUNT -c CONTAINER -n BLOB -f LOCAL_FILE

Azure Kubernetes Service (AKS)

az aks create -g RG -n CLUSTER --node-count 2
az aks get-credentials -g RG -n CLUSTER
az aks list
az aks show -g RG -n CLUSTER
az aks delete -g RG -n CLUSTER

Common Patterns

Pattern 1: Output Formatting

# Get only specific fields
az vm list --query "[].{name: name, state: powerState}"

# Get just the names
az vm list --query "[].name" -o tsv

# Filter and extract
az vm list --query "[?powerState=='VM running'].name"

Pattern 2: Automation & Scripting

#!/bin/bash
set -e  # Exit on error

# Get VM ID
VM_ID=$(az vm create \
  -g myRG \
  -n myVM \
  --image UbuntuLTS \
  --query id \
  --output tsv)

echo "Created VM: $VM_ID"

# Check provisioning state
az vm show --ids "$VM_ID" --query provisioningState

Pattern 3: Batch Operations

# Delete all VMs in a resource group
az vm list -g myRG -d --query "[].id" -o tsv | xargs az vm delete --ids

# List all resources by tag
az resource list --tag env=production

Pattern 4: Using Defaults

# Set defaults to reduce typing
az configure --defaults group=myRG subscription=mySubscription location=eastus

# Now commands are simpler
az vm create -n myVM --image UbuntuLTS  # group, subscription, location inherited

Helper Scripts

This skill includes helper bash scripts for common operations:

• azure-vm-status.sh — Check VM status across subscription
• azure-resource-cleanup.sh — Identify and remove unused resources
• azure-storage-analysis.sh — Analyze storage account usage and costs
• azure-subscription-info.sh — Get subscription quotas and limits
• azure-rg-deploy.sh — Deploy infrastructure with monitoring

Usage:

./scripts/azure-vm-status.sh -g myResourceGroup
./scripts/azure-storage-analysis.sh --subscription mySubscription

Advanced Topics

Output Querying with JMESPath

Azure CLI supports powerful output filtering using JMESPath:

# Sort results
az vm list --query "sort_by([], &name)"

# Complex filtering
az vm list --query "[?location=='eastus' && powerState=='VM running'].name"

# Aggregation
az vm list --query "length([])"  # Count VMs

Error Handling

# Check exit codes
az vm create -g RG -n VM --image UbuntuLTS
if [ $? -eq 0 ]; then
  echo "VM created successfully"
else
  echo "Failed to create VM"
  exit 1
fi

Authentication Methods

Service Principal (Automation):

az login --service-principal \
  --username $AZURE_CLIENT_ID \
  --password $AZURE_CLIENT_SECRET \
  --tenant $AZURE_TENANT_ID

Managed Identity (Azure Resources):

# On an Azure VM or Container Instance
az login --identity

Token-based (CI/CD):

echo "$AZURE_ACCESS_TOKEN" | az login --service-principal -u $AZURE_CLIENT_ID --password-stdin --tenant $AZURE_TENANT_ID

Key Resources

• Official Documentation: https://learn.microsoft.com/en-us/cli/azure/
• Command Reference: https://learn.microsoft.com/en-us/cli/azure/reference-index
• GitHub Repository: https://github.com/Azure/azure-cli
• Comprehensive Guide: See references/REFERENCE.md
• Release Notes: https://github.com/Azure/azure-cli/releases

Tips & Tricks

1. Enable Tab Completion:

   # macOS with Homebrew
   eval "$(az completion init zsh)"
   
   # Linux (bash)
   eval "$(az completion init bash)"
   

2. Find Commands Quickly:

   az find "create virtual machine"  # Search for commands
   

3. Use --no-wait for Long Operations:

   az vm create -g RG -n VM --image UbuntuLTS --no-wait
   # Check status later with az vm show
   

4. Save Frequently Used Parameters:

   az configure --defaults group=myRG location=eastus
   

5. Combine with Other Tools:

   # Use with jq for advanced JSON processing
   az vm list | jq '.[] | select(.powerState == "VM running") | .name'
   
   # Use with xargs for batch operations
   az storage account list --query "[].name" -o tsv | xargs -I {} az storage account show -g RG -n {}
   

Next Steps

• Review references/REFERENCE.md for comprehensive command documentation
• Explore helper scripts in the scripts/ directory
• Practice with non-production resources first
• Review Azure best practices and cost optimization strategies

---

Version: 1.0.0
License: MIT
Compatible with: Azure CLI v2.50+, Azure Subscription

Azure CLI Skill

Master Microsoft Azure cloud platform management via command-line interface.

This AgentSkills-compatible skill provides comprehensive knowledge of the Azure CLI (Command Line Interface) for managing Azure cloud resources, infrastructure, and services.

What is Azure CLI?

Azure CLI is a cross-platform command-line tool developed by Microsoft for managing Azure cloud resources. It provides complete access to Azure services including:

• Virtual Machines & Containers — VMs, VMSS, AKS, Container Instances
• Networking — VNets, Load Balancers, VPN, CDN, Application Gateway
• Storage & Databases — Storage Accounts, SQL Server, MySQL, PostgreSQL, CosmosDB
• Application Services — App Service, Functions, Web Apps, Container Apps
• Monitoring & Management — Azure Monitor, Log Analytics, Policy, RBAC
• DevOps & Automation — Azure DevOps, Pipelines, Extensions
• And 50+ more services

Installation

Quick Install

macOS:

brew install azure-cli

Linux:

curl -sL https://aka.ms/InstallAzureCliLinux | bash

Windows:

choco install azure-cli
# Or download MSI from https://aka.ms/InstallAzureCliWindowsMSI

Verify Installation

az --version
az login

Skill Contents

Main Documentation

• SKILL.md — Core Azure CLI skill with essential commands, patterns, and quick-start guides
• references/REFERENCE.md — Comprehensive command reference covering all 66 modules and 1000+ commands

Helper Scripts

Practical bash scripts for common Azure operations:

• azure-vm-status.sh — Check VM status and power states
• azure-resource-cleanup.sh — Identify and clean up unused resources
• azure-storage-analysis.sh — Analyze storage account usage
• azure-subscription-info.sh — Get subscription quotas and limits
• azure-rg-deploy.sh — Deploy infrastructure with monitoring

Usage:

chmod +x scripts/*.sh
./scripts/azure-vm-status.sh -g myResourceGroup
./scripts/azure-storage-analysis.sh -s mySubscription

Quick Start

1. Authenticate

az login                    # Opens browser for interactive login

2. Create a Resource Group

az group create -g myRG -l eastus

3. Create a Virtual Machine

az vm create \
  -g myRG \
  -n myVM \
  --image UbuntuLTS \
  --admin-username azureuser \
  --generate-ssh-keys

4. Manage Resources

az vm list -g myRG                          # List VMs
az vm show -g myRG -n myVM                  # Get details
az vm start -g myRG -n myVM                 # Start VM
az vm stop -g myRG -n myVM                  # Stop VM

Key Concepts

Global Parameters (work with all commands)

--subscription ID           # Target subscription
--resource-group -g RG     # Target resource group
--output -o json|table|tsv|yaml  # Output format
--query JMESPATH_QUERY      # Filter output
--verbose -v                # Verbose output
--help -h                   # Command help

Output Formatting

# Table (human-readable)
az vm list -g myRG --output table

# JSON (for scripting)
az vm list -g myRG --output json

# Extract specific fields
az vm list -g myRG --query "[].name" -o tsv

JMESPath Queries

# Get only running VMs
az vm list --query "[?powerState=='VM running'].name"

# Get specific fields
az vm list --query "[].{name: name, size: hardwareProfile.vmSize}"

# Count resources
az vm list --query "length([])"

Common Workflows

Scale a Web Application

# Create App Service Plan
az appservice plan create -g myRG -n myplan --sku B2 --is-linux

# Create Web App
az webapp create -g myRG -p myplan -n myapp

# Set configuration
az webapp config appsettings set -g myRG -n myapp \
  --settings WEBSITE_NODE_DEFAULT_VERSION=14.17.0

# Deploy code
az webapp deployment source config-zip -g myRG -n myapp --src myapp.zip

# Monitor performance
az monitor metrics list -g myRG --resource /subscriptions/.../providers/Microsoft.Web/sites/myapp

Deploy Infrastructure with Templates

# Validate template
az deployment group validate -g myRG --template-file template.json

# Deploy
az deployment group create -g myRG --template-file template.json --parameters params.json

# Monitor deployment
az deployment group show -g myRG -n deployment_name

Automate with Bash Scripts

#!/bin/bash
set -e  # Exit on error

# Create resource group
az group create -g myRG -l eastus

# Create and configure VM
VM_ID=$(az vm create -g myRG -n myVM --image UbuntuLTS \
  --query id --output tsv)

# Run startup script
az vm run-command invoke -g myRG -n myVM \
  --command-id RunShellScript \
  --scripts "sudo apt-get update && sudo apt-get install -y nginx"

echo "VM deployed: $VM_ID"

Best Practices

1. Use defaults to reduce typing:

   az configure --defaults group=myRG location=eastus
   

2. Authenticate securely:

   • Use az login for interactive sessions
   • Use service principals with environment variables for automation
   • Never hardcode credentials in scripts

3. Format output for scripting:

   # Extract values with --query and -o tsv
   VM_ID=$(az vm create ... --query id --output tsv)
   

4. Use --no-wait for long operations:

   az vm create ... --no-wait
   az vm show -g RG -n VM --query provisioningState  # Check later
   

5. Tag resources for cost tracking:

   az vm create -g RG -n VM ... --tags env=prod team=backend cost-center=123
   

6. Enable error handling in scripts:

   set -e                # Exit on error
   set -u                # Exit on undefined variable
   set -o pipefail       # Exit if pipe fails
   

Documentation

• Main Skill Guide: SKILL.md
• Command Reference: references/REFERENCE.md
• Helper Scripts: scripts/
• Official Azure CLI Docs: https://learn.microsoft.com/en-us/cli/azure/
• GitHub Repository: https://github.com/Azure/azure-cli

Getting Help

Built-in Help

az --help                          # General help
az vm --help                        # Module help
az vm create --help                 # Command help
az find "search term"              # Find commands

Resources

• Microsoft Learn: https://learn.microsoft.com/en-us/cli/azure/
• Command Reference: https://learn.microsoft.com/en-us/cli/azure/reference-index
• GitHub Issues: https://github.com/Azure/azure-cli/issues
• Stack Overflow: Tag with azure-cli

Authentication Methods

Interactive Login (Development)

az login

Service Principal (Automation/CI-CD)

az login --service-principal \
  --username $AZURE_CLIENT_ID \
  --password $AZURE_CLIENT_SECRET \
  --tenant $AZURE_TENANT_ID

Managed Identity (Azure Resources)

# On Azure VM, Container, or Function
az login --identity

Token-based (Advanced)

az login --service-principal -u $CLIENT_ID --password-stdin --tenant $TENANT_ID

License

MIT License - See LICENSE file for details

Source Information

• Project: Azure CLI
• Repository: https://github.com/Azure/azure-cli
• Latest Version: 2.82.0 (as of January 2026)
• Language: Python
• Community: 4,400+ stars, 1,200+ contributors

Contributing

This skill is based on official Azure CLI documentation and source code. For issues or improvements with Azure CLI itself, visit https://github.com/Azure/azure-cli

---

Skill Version: 1.0.0
Last Updated: January 24, 2026
Author: Dennis de Vaal d.devaal@gmail.com