azure-diagnostics Skill for Claude Code: Troubleshoot Azure Production Issues

Walks Claude through debugging Azure production problems in App Service, Functions, Container Apps, AKS, VMs and messaging.

Installs: 576.4K; on skills.sh
Stars: 1.6K; on GitHub
Files: 53; besides SKILL.md
Updated: Oct 2026; last repo commit

azure-diagnostics gives the agent a fixed triage order: identify the symptoms, check resource health, read logs, analyse metrics, then look at recent changes. It has guides for Container Apps, App Service, Function Apps, AKS, VM connectivity and Event Hubs or Service Bus.

When you supply logs and ask for evidence-only analysis, it does not touch Azure. Otherwise it can run bundled diagnostic scripts and Azure MCP tools such as AppLens and Azure Monitor against your account. The rules say to prefer those scripts over ad hoc calls for live collection.

Good for

Developers debugging a failing App Service, Function App or Container App
Platform engineers troubleshooting AKS, nodes and pods
Anyone who wants a structured diagnosis from logs they paste in

Install azure-diagnostics

Claude Code

Copy this prompt.

Install the azure-diagnostics skill in Claude Code. Run this command:

/plugin install azure@claude-plugins-official

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Azure account, Node.js 18+, Azure CLI signed in (az login).

This installs the Azure plugin, which includes azure-diagnostics with the other Azure skills and the Azure MCP server. Sign in to azd with azd auth login if you plan to deploy. Update with /plugin update azure@claude-plugins-official.

From the project README. Source.

What's in the skill

When it loads

Debug Azure production issues using AppLens, Azure Monitor, resource health, and safe triage, including evidence-only diagnosis without live access. WHEN: debug production issues, troubleshoot app service, app service high CPU, app service deployment failure, troubleshoot container apps, container app 503 or target port mismatch, troubleshoot functions, function telemetry missing or stopped after a config/connection-string change, troubleshoot AKS, VM RDP, Linux SSH, VM black screen, can't connect to VM, reset VM password, NSG or firewall blocking, kubectl cannot connect, kube-system/CoreDNS failures, pod pending, crashloop, node not ready, upgrade failures, analyze logs, KQL, insights, image pull failures, cold start issues, health probe failures, resource health, root cause of errors, troubleshoot event hubs, troubleshoot service bus, messaging SDK error, AMQP connection failure, message lock lost, lock renewal during long-running processing, service bus dead letter.

Sections in SKILL.md

Triggers
Rules
Quick Diagnosis Flow
Troubleshooting Guides by Service
Routing
Quick Reference
Common Diagnostic Commands
AppLens (MCP Tools)
Azure Monitor (MCP Tools)
Check Azure Resource Health
Using MCP
Using CLI
References

Key facts

Author: Microsoft
Repo: microsoft/azure-skills
Installs on skills.sh: 576,411 (Nov 2, 2026)
GitHub stars: 1,609 (Nov 2, 2026)
License: MIT
Last repo commit: Oct 30, 2026
Files next to SKILL.md: 53 files
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk pass
Needs: Azure account and Azure CLI signed in (az login); Node.js 18+; azd signed in for deployment
Bundled: 53 files: guides and 12 shell and PowerShell diagnostic scripts

What it includes

Symptoms, resource health, logs, metrics, recent changes
Quick diagnosis flow
Image pull failures, cold starts, high CPU, crashes, TLS and custom domains
Runs code · Container Apps and App Service
Invocation failures, timeouts, binding errors, missing app settings
Network · Function Apps
Cluster access, nodes, pods, ingress, DNS, upgrades; aks-baseline and pod-evidence scripts
Runs code · AKS troubleshooting
RDP and SSH failures, NSG and firewall blocks, credential resets
Runs code · VM connectivity
Event Hubs and Service Bus connection errors, AMQP failures, message locks
Runs code · Messaging
Azure MCP tools for automated diagnosis and KQL log queries
Network · AppLens and Azure Monitor
If you forbid live access, it diagnoses only from the logs and metrics you give it
Read · Evidence-only mode

From the official docs

Permissions

Medium risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It runs diagnostic scripts against your Azure resources
Prefer a read-only role, and read a script before the agent runs it. github.com
Logs and traces can hold sensitive data
Production logs may contain tokens and personal data. Redact before sharing, or use evidence-only mode. github.com
Some guides include fixes, credential resets and upgrades
The SKILL.md lists VM credential resets, and the AKS guides list optional operations and upgrade steps. Approve each one separately. github.com

Technical details

Talks to	Azure through az CLI, Azure MCP tools and the bundled scripts
Scopes	Resource health, logs and metrics from your Azure subscription Logs you paste in

Questions

What does azure-diagnostics do?

It runs a structured troubleshooting process for Azure services and picks the right guide for the service that is failing.

How do I install azure-diagnostics?

Use the install box at the top. It comes with the Azure plugin, which also adds the Azure MCP server the skill uses for AppLens and Monitor.

Can I use it without giving Claude access to Azure?

Yes. Tell it to do evidence-only analysis or not to use live Azure access, and paste your logs and metrics. It will then diagnose from those and not run the scripts.

Does it change anything in Azure?

The core flow reads health, logs and metrics. Some guides include remediation or optional operations, so read each command before you approve it.

What do I need before using it?

An Azure account, Node.js 18+ and the Azure CLI signed in with az login.

Is it safe?

It runs scripts and az commands against your subscription, and logs can contain sensitive data. Use a read-only role where you can. Skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk pass.

Information

updated Nov 2, 2026

Repository: microsoft/azure-skills
Folder: skills/azure-diagnostics

microsoft/azure-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 3

Azure Skills README · github.com
azure-diagnostics SKILL.md · github.com
azure-diagnostics on skills.sh · skills.sh