CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

azure-diagnostics

Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe triage. 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.

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.github/plugins/azure-skills/skills/azure-diagnostics/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is well-structured with a clear diagnosis flow and a service routing table, but its guidance is undermined by bundle integrity problems: three of six service guides point to nonexistent files, the bundled diagnostic scripts are mandated by rule but never identified, and the trigger list plus several CLI blocks duplicate content. Workflow steps exist but lack any verification checkpoints.

Suggestions

Fix or add the missing troubleshooting/ files (aks-troubleshooting.md, vm-troubleshooting.md, messaging/README.md) — or repoint the routing table, Routing section, and References section to the paths that actually exist in the bundle.

Name and link the bundled diagnostic scripts (e.g., scripts/aks-baseline.sh, scripts/appservice-diagnostics.sh, scripts/test-messaging-connectivity.sh) in Rule 7 or a table, since the rules direct running 'the applicable script first' without ever identifying one.

Add a verification step to the Quick Diagnosis Flow (e.g., confirm the suspected root cause against resource health/logs before remediating, and re-check the symptom after remediation), and trim the duplicated Triggers section and repeated az CLI blocks.

DimensionReasoningScore

Conciseness

Mostly lean (tables, terse rules, command blocks, no explaining concepts Claude already knows), but there is real tightening to do: the 14-bullet Triggers section largely duplicates the frontmatter description's trigger list; 'az resource show' and 'az monitor activity-log list' appear identically in both 'Quick Reference' and 'Check Azure Resource Health'; and the 'AUTHORITATIVE GUIDANCE — MANDATORY COMPLIANCE' banner adds no information. This fits anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened'); not 4 because the duplication is recurring, not a minor instance.

3 / 5

Actionability

There is concrete, executable guidance (az CLI commands, a KQL example query, a routing table), but key details are missing: the three primary troubleshooting guides referenced for AKS, VM, and Messaging ('troubleshooting/aks/aks-troubleshooting.md', 'troubleshooting/compute/vm-troubleshooting.md', 'troubleshooting/messaging/README.md') do not exist in the bundle, so following the routing leads nowhere for half the services; the MCP blocks use a non-executable intent/command/parameters pseudocode format; and Rule 7 directs 'run the applicable script first' without ever naming or linking any of the 12 bundled scripts in scripts/. This matches anchor 3 ('some concrete guidance but incomplete... missing key details'); not 4 because the broken links and unnamed scripts are gaps in the core guidance, not minor ones.

3 / 5

Workflow Clarity

The 'Quick Diagnosis Flow' gives a coherent 5-step sequence (identify symptoms, check resource health, review logs, analyze metrics, investigate recent changes) reinforced by Rules 4 and 7, but there are no validation checkpoints or feedback loops — nothing like 'verify the remediation resolved the symptom' or what to do when a step yields nothing. This matches anchor 3 ('steps listed but validation gaps; sequence present but checkpoints missing or implicit'); not 4 because every checkpoint in the flow is implicit.

3 / 5

Progressive Disclosure

Structure is good in places — a service routing table with clearly signaled references, one-level-deep reference dirs (references/functions/ with README.md, durable.md, triggers.md), and top-level reference files that all exist. But scored against the actual bundle: 3 of the 9 referenced paths (the entire troubleshooting/ tree) are missing, and the 12 scripts in scripts/ are never linked or named anywhere despite Rule 7 making them the preferred collection path. That is more than the 'minor organization gaps' of anchor 4, fitting anchor 3 ('some structure but could be better organized').

3 / 5

Total

12

/

20

Passed

Description

91%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that explicitly states what the skill does and provides an exceptionally comprehensive, natural-language trigger catalog across Azure services. The main weakness is that it leans on keyword enumeration rather than articulated capabilities, and a few generic terms ('analyze logs', 'root cause of errors') create minor overlap risk.

DimensionReasoningScore

Specificity

The 'what' clause names concrete capabilities — 'Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe triage' — but the bulk of the description is a trigger-term catalog rather than distinct capability statements. This matches anchor 4 ('lists several specific actions; minor gaps in coverage') better than 5, where the action coverage itself would be comprehensive rather than carried by scenario keywords.

4 / 5

Completeness

Both questions are answered explicitly: what ('Debug Azure production issues... using AppLens, Azure Monitor, resource health, and safe triage') and when (an explicit 'WHEN:' clause with dozens of concrete trigger phrases). This mirrors the anchor-5 good example structure ('what. Use when...'); not 4 because the 'when' is not merely present but exhaustive and concrete.

5 / 5

Trigger Term Quality

Highly natural user phrases with synonyms and variations: 'troubleshoot app service', 'app service high CPU', 'VM RDP', 'Linux SSH', 'can't connect to VM', 'reset VM password', 'kubectl cannot connect', 'crashloop', 'pod pending', 'AMQP connection failure', 'message lock lost', 'service bus dead letter'. Coverage is comprehensive across services, matching the anchor-5 example's inclusion of synonyms and fine-grained variants; not 4 because almost no common variation is missing.

5 / 5

Distinctiveness Conflict Risk

The niche is clear — Azure production diagnostics — with Azure-specific triggers (AppLens, AKS, NSG, kube-system/CoreDNS, App Service) that rarely collide with other skills. However generic phrases like 'analyze logs', 'KQL, insights', and 'root cause of errors' could overlap a general log-analysis or observability skill, keeping it at anchor 4 ('mostly distinct; minor overlap risk') rather than 5.

4 / 5

Total

18

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 8 missing, 13 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 5 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

microsoft/azure-skills

Path

.github/plugins/azure-skills/skills/azure-diagnostics/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.