CtrlK
BlogDocsLog inGet started
Tessl Logo

azure-diagnostics

**WORKFLOW SKILL** — Debug and troubleshoot Azure production issues: Container Apps + Function Apps diagnostics, KQL log analysis, health checks. WHEN: 'debug production issues', 'troubleshoot container apps', 'troubleshoot function apps', 'image pull failures', 'cold start issues', 'health probe failures'. DO NOT USE FOR: pre-deployment validation (azure-validate), cost analysis (azure-cost-optimization).

62

Quality

72%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.github/skills/azure-diagnostics/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

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

This is an excellent skill description that hits all the marks. It provides specific concrete actions, natural trigger terms, explicit when/when-not guidance, and clear boundaries against related skills. The 'DO NOT USE FOR' clause is a particularly strong addition that reduces conflict risk with adjacent Azure skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'Container Apps + Function Apps diagnostics', 'KQL log analysis', 'health checks', and names specific issues like 'image pull failures', 'cold start issues', 'health probe failures'.

3 / 3

Completeness

Clearly answers both 'what' (debug/troubleshoot Azure production issues with specific diagnostics and log analysis) and 'when' (explicit WHEN clause with trigger phrases). Also includes a 'DO NOT USE FOR' clause that further clarifies boundaries.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would say: 'debug production issues', 'troubleshoot container apps', 'troubleshoot function apps', 'image pull failures', 'cold start issues', 'health probe failures'. These are realistic phrases a user would type.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche (Azure production debugging) and explicit boundary markers via 'DO NOT USE FOR' that distinguish it from related skills like azure-validate and azure-cost-optimization. The specific trigger terms (image pull failures, cold start issues) are unlikely to conflict with other skills.

3 / 3

Total

12

/

12

Passed

Implementation

44%

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

The skill has good structural organization and progressive disclosure with clear references to deeper materials, but suffers from a vague diagnostic workflow that lacks decision points and validation steps critical for production troubleshooting. There's notable redundancy (duplicate commands, overlapping reference sections) and the MCP tool examples use a non-standard format that reduces actionability. The high-level 5-step process needs concrete decision trees and feedback loops to be useful for real debugging scenarios.

Suggestions

Replace the vague 5-step diagnostic flow with a concrete decision tree: e.g., 'If health check returns Degraded → check activity log for platform events → if image pull error → see container-apps guide; if timeout → check scaling config'

Remove duplicate content: the CLI commands in 'Quick Reference' and 'Check Azure Resource Health' overlap, and the 'References' list and 'Reference Index' table are redundant — consolidate into one

Add a concrete end-to-end example showing diagnosis of a specific issue (e.g., image pull failure) from symptom identification through resolution verification

Remove the 'AUTHORITATIVE GUIDANCE' banner and 'Triggers' section — these waste tokens on content that doesn't help Claude execute the skill

DimensionReasoningScore

Conciseness

The skill has some unnecessary verbosity — the 'AUTHORITATIVE GUIDANCE — MANDATORY COMPLIANCE' banner is pompous filler, the 'Triggers' section restates what the YAML description already covers, and the diagnostic commands appear twice (Quick Reference and Check Azure Resource Health both show `az resource show` and `az monitor activity-log list`). The References section and Reference Index table are also largely redundant with each other.

2 / 3

Actionability

Provides concrete CLI commands and MCP tool invocations with parameter structures, which is good. However, the MCP tool examples use a pseudo-format that isn't clearly executable, the 5-step diagnostic flow is vague ('What's failing?', 'What do logs show?'), and there's no concrete example of actually diagnosing a specific issue end-to-end. The commands use placeholders like RESOURCE_ID and RG without showing how to obtain them.

2 / 3

Workflow Clarity

The 5-step diagnostic flow is extremely high-level with no validation checkpoints, no feedback loops, and no guidance on what to do when a step reveals something. For a troubleshooting skill involving production systems, there's no 'if X then Y' decision tree, no escalation path, and no verification that a fix actually resolved the issue. The steps are essentially just category labels rather than an actionable workflow.

1 / 3

Progressive Disclosure

The skill provides a clear overview with well-organized references to deeper content. The service-specific troubleshooting table points to dedicated subdirectories, the Reference Index table with 'When to Load' guidance is well-structured, and the instruction to load on demand is appropriate. References are one level deep and clearly signaled.

3 / 3

Total

8

/

12

Passed

Validation

100%

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

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
jonathan-vella/azure-agentic-infraops
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.