azure-resource-health-diagnose Skill for Claude Code: What It Does and How to Install It

Makes Claude check one Azure resource, read its logs, and write a remediation plan for the problems it finds.

Installs: 8.7K; on skills.sh
Stars: 40.7K; on GitHub
Updated: Oct 2026; last repo commit

Give it the name of an Azure resource. Claude follows seven steps from the SKILL.md: load Azure best practices, find the resource, check its health, run log queries, classify the issues, draft a remediation plan, then show a summary and ask "Proceed with detailed remediation plan? (y/n)" before it writes the full report.

It needs the Azure MCP server configured and signed in, and a resource that is deployed and running so it has logs. The SKILL.md prefers the Azure MCP tools and falls back to the Azure CLI. It lists Web Apps, Function Apps, VMs, Cosmos DB, Storage, SQL Database, Application Insights, Key Vault and Service Bus as resource types it knows how to check. This is a community skill from the awesome-copilot collection, written for GitHub Copilot, and the plugin manifests that list it name Awesome Copilot Community as the author.

Good for

Engineers triaging an incident on an Azure resource
Teams running Web Apps, Functions, VMs, Cosmos DB, Storage or SQL Database
Anyone who wants a ranked fix list with validation and rollback steps

Install azure-resource-health-diagnose

Claude Code

Copy this prompt.

Install the azure-resource-health-diagnose skill in Claude Code. Run this command:

claude mcp add azure-mcp-server -- npx -y @azure/mcp@latest server start

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 Node.js, Azure sign-in (az login).

Do both steps: step 1 adds the Azure server the skill calls, step 2 adds the skill. The folder routes replace step 2. Sign in with az login first; add --read-only after server start in step 1 to block changes (the Azure MCP server's azmcp-commands.md lists the flag). The azure-cloud-development plugin (Copilot CLI) also holds this skill; it lists 4 skills and 7 agents. The devops-oncall plugin lists 2 skills and 1 agent. The plugin folders on the main branch hold plugin.json and a README only, so check what the install adds. Step 1 is our wrapper (generated) around the README's npx command. The README's own Claude Code route is the Azure plugin, which it says packages the Azure MCP Server with Azure agents and skills; we have not inspected what that plugin adds, and it would replace step 1.

Built from the package data we hold. Not yet tested by us. Source.

What's in the skill

When it loads

Analyze Azure resource health, diagnose issues from logs and telemetry, and create a remediation plan for identified problems.

Sections in SKILL.md

Prerequisites
Workflow Steps
Step 1: Get Azure Best Practices
Step 2: Resource Discovery & Identification
Step 3: Health Status Assessment
Step 4: Log & Telemetry Analysis
Step 5: Issue Classification & Root Cause Analysis
Step 6: Generate Remediation Plan
Step 7: User Confirmation & Report Generation
Error Handling
Success Criteria

Key facts

Author: Awesome Copilot Community (author listed in the plugin.json files that include it)
License: MIT (LICENSE: Copyright GitHub, Inc.)
Installs on skills.sh: 8,662 (Nov 2, 2026)
GitHub stars: 40,666 for the whole github/awesome-copilot repo (Nov 2, 2026)
Last repo commit: Oct 30, 2026
What it includes: 1 file: SKILL.md. It bundles no scripts
skills.sh audits: Gen Agent Trust Hub: pass; Socket: pass; Snyk: warn (Nov 2, 2026)
Needs: Azure MCP server configured and signed in; a deployed Azure resource

What it includes

Loads diagnostic guidance from the Azure MCP best practices tool
Claude uses the guidance to shape the diagnosis and the fixes it suggests.
Try: “Diagnose the health of my Azure web app and tell me what to fix”
Network · Step 1: Get Azure best practices
Looks the resource up across subscriptions and detects its type
Uses azmcp-subscription-list and az resource list --name. If several resources match, it asks you for the subscription or resource group.
Runs code · Step 2: Find the resource
Checks provisioning state, availability, recent changes and utilisation
Looks at service-specific signals such as HTTP codes for Web Apps or connection success for databases.
Network · Step 3: Check health
Runs KQL queries through the Azure MCP monitor tools
Finds Log Analytics workspaces and tables, then runs azmcp-monitor-log-query for errors, performance and failed requests.
Runs code · Step 4: Query logs and telemetry
Sorts issues into Critical, High, Medium and Low
Groups causes into configuration, resource limits, network, application, external dependencies and security.
Read · Step 5: Classify and find root cause
Drafts immediate, short-term and long-term fixes
Each item comes with Azure CLI commands, validation steps and a rollback plan.
Read · Step 6: Write the remediation plan
Shows a summary, then asks before writing the full report
Asks "Proceed with detailed remediation plan? (y/n)". The detailed report has an executive summary, metrics, issues, phased fixes and prevention measures.
Read · Step 7: Confirm and report

From the official docs

Permissions

Medium risk

What it can do

Read your data
Create and change things
Delete things
Read-only modeHow to turn it on

Watch out for

The plan contains Azure CLI commands
Step 6 lists commands to restore service, scale or change configuration. Read each command before you run it, and test it outside production first. github.com
It depends on the Azure MCP server
The Azure MCP server's command reference (azmcp-commands.md) lists a --read-only option on azmcp server start. Add it after "server start" while you only want a diagnosis. github.com
Copilot CLI plugins add agents
The devops-oncall plugin adds the azure-principal-architect agent. The azure-cloud-development plugin adds 7 agents, and the azure-principal-architect agent lists editFiles and runCommands among its tools. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	Not a skill setting. The Azure MCP server lists a --read-only option for server start in its azmcp-commands.md.
Sign-in and keys	The skill itself names no key. Access comes from the Azure sign-in the Azure MCP server uses.
Scopes	Reads resource details, logs and telemetry from your Azure subscriptions through the Azure MCP server Runs KQL queries with azmcp-monitor-log-query and may run az resource list Writes a remediation plan that contains Azure CLI commands

Questions

What does the azure-resource-health-diagnose skill do?

It makes your agent check one Azure resource, read its logs and telemetry, and write a remediation plan. The plan ranks issues by severity and includes Azure CLI commands, validation steps and rollback steps.

How do I install it in Claude Code?

Use the install box at the top of this page. Add the Azure MCP server first (step 1), then the skill (step 2). The skill expects the Azure tools to be there.

Does it need an Azure account or API key?

It needs the Azure MCP server configured and authenticated, and a deployed resource that produces logs. The Azure MCP README lists the Azure CLI signed in with az login as a prerequisite. The SKILL.md names no separate API key.

Is it safe?

It reads resource, log and telemetry data from your Azure account through the Azure MCP server. It then writes a plan that contains Azure CLI commands, and step 7 asks you before the detailed report. Our advice: run those commands yourself after reading them, and start the Azure server with --read-only while you diagnose.

Does it work in the Claude app, Codex or Copilot?

The install box has Claude Code, Codex and Copilot CLI routes. There is no Claude app upload route, because the skill needs the Azure MCP server and the Azure CLI on your machine. The awesome-copilot README is written for GitHub Copilot.

Which plugin includes it?

In the awesome-copilot repo, the azure-cloud-development plugin lists it with 3 other skills and 7 agents, and the devops-oncall plugin lists it with 1 other skill and 1 agent. Both install with the Copilot CLI.

Information

updated Nov 2, 2026

Repository: github/awesome-copilot
Folder: skills/azure-resource-health-diagnose

github/awesome-copilot skills.sh

Sources

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

Show all 8

azure-resource-health-diagnose SKILL.md · github.com
awesome-copilot README · github.com
azure-cloud-development plugin.json · github.com
devops-oncall plugin.json · github.com
azure-cloud-development README · github.com
devops-oncall README · github.com
Azure MCP server README · github.com
github.com · github.com