CtrlK
BlogDocsLog inGet started
Tessl Logo

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, troubleshoot functions, troubleshoot AKS, 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, service bus dead letter.

64

Quality

78%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

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

65%

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

The body is actionable and well-structured with executable CLI/MCP examples and a clear diagnostic flow, but it carries ceremonial padding, lacks validation checkpoints in its workflow, and ships two broken troubleshooting links.

Suggestions

Add or fix the referenced troubleshooting/aks/aks-troubleshooting.md and troubleshooting/messaging/README.md files (or remove the dangling links) so navigation is intact.

Add explicit validation/error-recovery checkpoints to the Quick Diagnosis Flow (e.g., "if resource health shows degraded, pivot to platform issue") to lift workflow clarity.

Remove the "AUTHORITATIVE GUIDANCE — MANDATORY COMPLIANCE" blockquote and trim the Triggers section, which duplicates the description's WHEN clause.

DimensionReasoningScore

Conciseness

Mostly efficient — compact tables, short rules, and tight command blocks instead of prose explaining Azure concepts. But the "AUTHORITATIVE GUIDANCE — MANDATORY COMPLIANCE" blockquote is ceremonial filler and the Triggers section largely duplicates the WHEN clause already in the description, so it could be tightened. Not 3 because of that padding; not 1 because it does not explain concepts Claude already knows.

2 / 3

Actionability

Provides copy-paste-ready executable commands — "az resource show --ids RESOURCE_ID", "az monitor activity-log list -g RG --max-events 20", "az containerapp logs show --name APP -g RG --follow", an App Insights KQL query — plus parameterized MCP invocation snippets. This matches fully executable, specific examples rather than pseudocode.

3 / 3

Workflow Clarity

A clear numbered Quick Diagnosis Flow (identify symptoms, check resource health, review logs, analyze metrics, investigate changes) exists, but there are no explicit validation checkpoints or error-recovery feedback loops for operations that can be destructive/batch in nature. This matches "steps listed but validation gaps"; not 3 due to missing checkpoints, not 1 because the sequence is clear.

2 / 3

Progressive Disclosure

Good one-level-deep overview pointing to references/ files (container-apps, app-service, functions, kql-queries, azure-resource-graph) that all exist, with a service table and References section signaling navigation. However troubleshooting/aks/aks-troubleshooting.md and troubleshooting/messaging/README.md are referenced in the body but are missing from the bundle — dangling links that break navigation, preventing a 3.

2 / 3

Total

9

/

12

Passed

Description

92%

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, highly specific description with explicit what/when triggers and rich natural keyword coverage. Its main weakness is an unusually broad multi-service scope that raises conflict risk with dedicated AKS or messaging skills.

Suggestions

Consider narrowing the description or splitting AKS/messaging into separate skills so this one does not compete with service-specific skills for the same triggers.

Drop the redundant "on Azure" (already stated as "Azure production issues") to tighten the lead clause.

DimensionReasoningScore

Specificity

Lists multiple concrete diagnostic actions and tools — "Debug Azure production issues... using AppLens, Azure Monitor, resource health, and safe triage" — matching the anchor for enumerating several specific concrete actions. It is above 2 because it goes well beyond naming a domain plus a few actions.

3 / 3

Completeness

Explicitly answers both what ("Debug Azure production issues... using AppLens, Azure Monitor, resource health, and safe triage") and when via an explicit "WHEN:" trigger clause with concrete scenarios. An equivalent explicit trigger clause is present, so the missing-Use-when cap does not apply.

3 / 3

Trigger Term Quality

Natural trigger phrases a user/ops engineer would say are present in abundance: "troubleshoot app service", "app service high CPU", "troubleshoot AKS", "kubectl cannot connect", "pod pending", "crashloop", "image pull failures", "cold start issues", "AMQP connection failure", "message lock lost". Voice is imperative/third person ("Debug", "troubleshoot") with no first/second person, so no specificity penalty applies.

3 / 3

Distinctiveness Conflict Risk

Anchored to Azure diagnostics (not generic), but its scope spans App Service, Container Apps, Functions, AKS, Event Hubs, and Service Bus, creating real overlap with dedicated service-specific skills. This matches "somewhat specific but could still overlap with similar skills"; it is not a tight distinct niche (3) yet not generic (1).

2 / 3

Total

11

/

12

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.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 5 missing, 10 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
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.