Azure Specialist
Structured investigation for Azure workloads. Five phases: gather context,
diagnose, design, recommend, verify.
Arguments
$0 — subscription context, service scope, or problem description. Required.
Phase 1: Context Gathering
- Identify the tenant, subscription(s), resource group(s), and services in scope.
- Glob for IaC in the working directory:
**/*.bicep, **/azuredeploy.json, **/main.tf, **/*.parameters.json.
- If Azure CLI access is available:
az account show
az group list --query "[].name"
- Note which resource providers are registered:
az provider list --query "[?registrationState=='Registered'].namespace" -o tsv
Phase 2: Diagnosis
Compute / containers:
az vm list --query "[].{name:name,rg:resourceGroup,state:powerState}" -o table
az aks list --query "[].{name:name,rg:resourceGroup,version:kubernetesVersion}" -o table
az webapp list --query "[].{name:name,rg:resourceGroup,state:state}" -o table
Identity / RBAC:
az role assignment list --assignee <principal-id> --all
az ad app list --display-name <name>
az identity list --resource-group <rg>
Networking:
az network vnet list
az network nsg rule list --nsg-name <nsg> --resource-group <rg>
az network private-endpoint list
Serverless / events:
az functionapp list
az servicebus namespace list
az eventgrid topic list
Cost / quotas:
az consumption usage list --start-date <> --end-date <>
az vm list-usage --location <region>
Phase 3: Design / Root-Cause Analysis
Map symptoms to causes:
| Symptom |
Common Causes |
Check |
| AKS pod AuthN fails |
Managed Identity not assigned, missing federated credential |
az aks show --query identity + pod ServiceAccount annotations |
| App Service slow |
Cold start on consumption plan, misconfigured scale rules |
Plan tier, autoscale settings |
| Storage 403 |
Private endpoint with wrong DNS, firewall IP allowlist |
az storage account network-rule list |
| Function cold starts |
Consumption plan + infrequent traffic |
Switch to Premium or Always-Ready instances |
| Cosmos DB throttle (429) |
RU/s too low, hot partition |
Diagnostic settings, metrics, partition key review |
| EntraID app login fails |
Redirect URI mismatch, missing API permission grant |
az ad app show + consent status |
Cite resource ID or file:line for every finding.
Phase 4: Recommendations
Output findings in priority order:
[CRITICAL] <title>
Resource: <resource ID or file:line>
Issue: <one sentence>
Evidence: <CLI output or code snippet>
Fix: <specific change, with Bicep/ARM/Terraform diff>
Trade-off: <alternative and its downside, if meaningful>
- Order: CRITICAL → WARNING → INFO.
- For IaC fixes, show the exact Bicep/ARM/Terraform diff.
- Reference relevant docs in
references/ where applicable.
Phase 5: Verification
After fixes are applied:
- Re-run the diagnostic command that surfaced the issue.
- For RBAC/Managed Identity changes: verify with
az role assignment list and a live workload token request.
- For network changes:
az network watcher test-connectivity or NSG flow-log review.
- For Bicep/ARM deployments: run
what-if before and after to confirm intended drift only.
- Check Azure Monitor metrics and Service Health — no new alerts should be firing.
Reference Docs
Consult references/ for decision guides:
| File |
When to use |
compute.md |
AKS, ACI, VMs, App Service |
serverless.md |
Functions, Logic Apps, Service Bus, Event Grid |
storage.md |
Blob, Files, Queues, Cosmos DB, Azure SQL |
networking.md |
VNet, App Gateway, Front Door, Private Endpoints |
identity.md |
EntraID, Managed Identity, RBAC scopes |
devops.md |
Azure Pipelines, ACR, release management |
iac-patterns.md |
Bicep, ARM, Terraform (AzureRM/azapi) patterns |
1---2# dotbabel:generated projection=sha256:732eb07ae47b82ec57d879a6f5a5fa4f8b8fd7f1010efcdc68450f897b4e27f9 source=skills/azure-specialist/SKILL.md — do not edit directly3allowed-tools: Read Grep Glob Bash4argument-hint: <subscription context, service, or problem description>5description: |6 Deep-dive Azure architecture review, debugging, and service design. Use for structured investigations of Azure-specific issues, identity or cost audits, and multi-service design reviews. Triggers on: "Azure audit", "Azure design review", "EntraID review", "Managed Identity debug", "review my Azure", "Azure troubleshooting", "AKS deep-dive".7name: azure-specialist-38metadata:9 source: https://skillmd.com/skills/kaiohenricunha/azure-specialist-310---1112# Azure Specialist1314Structured investigation for Azure workloads. Five phases: gather context,15diagnose, design, recommend, verify.1617## Arguments1819- `$0` — subscription context, service scope, or problem description. Required.2021---2223## Phase 1: Context Gathering24251. Identify the tenant, subscription(s), resource group(s), and services in scope.262. Glob for IaC in the working directory: `**/*.bicep`, `**/azuredeploy.json`, `**/main.tf`, `**/*.parameters.json`.273. If Azure CLI access is available:28 ```bash29 az account show30 az group list --query "[].name"31 ```324. Note which resource providers are registered:33 ```bash34 az provider list --query "[?registrationState=='Registered'].namespace" -o tsv35 ```3637---3839## Phase 2: Diagnosis4041**Compute / containers:**4243```bash44az vm list --query "[].{name:name,rg:resourceGroup,state:powerState}" -o table45az aks list --query "[].{name:name,rg:resourceGroup,version:kubernetesVersion}" -o table46az webapp list --query "[].{name:name,rg:resourceGroup,state:state}" -o table47```4849**Identity / RBAC:**5051```bash52az role assignment list --assignee <principal-id> --all53az ad app list --display-name <name>54az identity list --resource-group <rg>55```5657**Networking:**5859```bash60az network vnet list61az network nsg rule list --nsg-name <nsg> --resource-group <rg>62az network private-endpoint list63```6465**Serverless / events:**6667```bash68az functionapp list69az servicebus namespace list70az eventgrid topic list71```7273**Cost / quotas:**7475```bash76az consumption usage list --start-date <> --end-date <>77az vm list-usage --location <region>78```7980---8182## Phase 3: Design / Root-Cause Analysis8384Map symptoms to causes:8586| Symptom | Common Causes | Check |87| ------------------------ | ----------------------------------------------------------- | --------------------------------------------------------------- |88| AKS pod AuthN fails | Managed Identity not assigned, missing federated credential | `az aks show --query identity` + pod ServiceAccount annotations |89| App Service slow | Cold start on consumption plan, misconfigured scale rules | Plan tier, autoscale settings |90| Storage 403 | Private endpoint with wrong DNS, firewall IP allowlist | `az storage account network-rule list` |91| Function cold starts | Consumption plan + infrequent traffic | Switch to Premium or Always-Ready instances |92| Cosmos DB throttle (429) | RU/s too low, hot partition | Diagnostic settings, metrics, partition key review |93| EntraID app login fails | Redirect URI mismatch, missing API permission grant | `az ad app show` + consent status |9495Cite resource ID or `file:line` for every finding.9697---9899## Phase 4: Recommendations100101Output findings in priority order:102103```104[CRITICAL] <title>105Resource: <resource ID or file:line>106Issue: <one sentence>107Evidence: <CLI output or code snippet>108Fix: <specific change, with Bicep/ARM/Terraform diff>109Trade-off: <alternative and its downside, if meaningful>110```111112- Order: CRITICAL → WARNING → INFO.113- For IaC fixes, show the exact Bicep/ARM/Terraform diff.114- Reference relevant docs in `references/` where applicable.115116---117118## Phase 5: Verification119120After fixes are applied:1211221. Re-run the diagnostic command that surfaced the issue.1232. For RBAC/Managed Identity changes: verify with `az role assignment list` and a live workload token request.1243. For network changes: `az network watcher test-connectivity` or NSG flow-log review.1254. For Bicep/ARM deployments: run `what-if` before and after to confirm intended drift only.1265. Check Azure Monitor metrics and Service Health — no new alerts should be firing.127128---129130## Reference Docs131132Consult `references/` for decision guides:133134| File | When to use |135| ----------------- | ------------------------------------------------ |136| `compute.md` | AKS, ACI, VMs, App Service |137| `serverless.md` | Functions, Logic Apps, Service Bus, Event Grid |138| `storage.md` | Blob, Files, Queues, Cosmos DB, Azure SQL |139| `networking.md` | VNet, App Gateway, Front Door, Private Endpoints |140| `identity.md` | EntraID, Managed Identity, RBAC scopes |141| `devops.md` | Azure Pipelines, ACR, release management |142| `iac-patterns.md` | Bicep, ARM, Terraform (AzureRM/azapi) patterns |