CtrlK
BlogDocsLog inGet started
Tessl Logo

azure-messaging

Troubleshoot and resolve issues with Azure Messaging SDKs for Event Hubs and Service Bus. Covers connection failures, authentication errors, message processing issues, and SDK configuration problems. WHEN: event hub SDK error, service bus SDK issue, messaging connection failure, AMQP error, event processor host issue, message lock lost, message lock expired, lock renewal, lock renewal batch, send timeout, receiver disconnected, SDK troubleshooting, azure messaging SDK, event hub consumer, service bus queue issue, topic subscription error, enable logging event hub, service bus logging, eventhub python, servicebus java, eventhub javascript, servicebus dotnet, event hub checkpoint, event hub not receiving messages, service bus dead letter, batch processing lock, session lock expired, idle timeout, connection inactive, link detach, slow reconnect, session error, duplicate events, offset reset, receive batch.

53

Quality

58%

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/plugins/azure-skills/skills/azure-messaging/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

89%

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 a strong skill description with excellent trigger term coverage and clear distinctiveness. The explicit WHEN clause with extensive natural keywords ensures Claude can reliably select this skill for Azure Messaging SDK issues. The main weakness is that the 'what' portion could be more specific about concrete actions rather than listing broad categories of issues.

Suggestions

Strengthen specificity by listing concrete actions like 'diagnose AMQP connection drops', 'configure checkpoint stores', 'resolve dead-letter queue buildup', 'enable SDK diagnostic logging' instead of broad categories like 'connection failures' and 'authentication errors'.

DimensionReasoningScore

Specificity

The description names the domain (Azure Messaging SDKs for Event Hubs and Service Bus) and lists categories of issues (connection failures, authentication errors, message processing issues, SDK configuration problems), but doesn't list specific concrete actions like 'diagnose AMQP connection drops' or 'configure checkpoint stores'. The actions are more categorical than concrete.

2 / 3

Completeness

Clearly answers both 'what' (troubleshoot and resolve issues with Azure Messaging SDKs covering connection failures, authentication errors, etc.) and 'when' (explicit WHEN clause with extensive trigger terms). The WHEN clause serves as an explicit trigger guidance section.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would actually say, including specific error conditions ('message lock lost', 'message lock expired', 'send timeout', 'receiver disconnected'), SDK-language combinations ('eventhub python', 'servicebus java', 'servicebus dotnet'), and common symptoms ('event hub not receiving messages', 'service bus dead letter', 'duplicate events', 'slow reconnect'). These closely match real user queries.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche: Azure Messaging SDKs specifically for Event Hubs and Service Bus. The trigger terms are very specific to this domain (AMQP error, event processor host, message lock, checkpoint, dead letter) and unlikely to conflict with other skills.

3 / 3

Total

11

/

12

Passed

Implementation

27%

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

This skill provides a reasonable structural framework for Azure Messaging SDK troubleshooting but lacks substantive content. It has no concrete examples, no executable code or queries, no specific error-to-resolution mappings, and references troubleshooting guides that don't exist in the bundle. It reads more like a table of contents for content that was never written.

Suggestions

Add concrete examples of common errors with specific resolutions (e.g., 'MessageLockLostException' → renew lock before processing, with code snippets for each SDK language)

Include at least 2-3 executable KQL queries for diagnosing common issues via mcp_azure_mcp_monitor logs_query

Either provide the referenced 'troubleshooting/messaging/' bundle files or inline the key troubleshooting content directly in the skill

Add a verification step to the diagnosis workflow (e.g., 'After applying fix, verify by checking logs/re-running the failing operation') and include feedback loops for when initial remediation fails

DimensionReasoningScore

Conciseness

Mostly efficient with good table formatting, but the 'When to Use This Skill' section largely duplicates what would be in the YAML description/triggers. The MCP tools table is useful but some entries are somewhat obvious. Overall reasonably lean but could be tighter.

2 / 3

Actionability

No concrete code examples, no specific commands, no executable KQL queries, no example error messages with resolutions. The diagnosis workflow is abstract ('match against language-specific troubleshooting guide', 'apply remediation') without showing what that actually looks like. The troubleshooting guides are referenced but not provided in the bundle.

1 / 3

Workflow Clarity

The 6-step diagnosis workflow provides a reasonable sequence, but lacks validation checkpoints, feedback loops for when fixes don't work, and concrete details at each step. There's no 'if this doesn't resolve it, try X' pattern, and no verification step after applying a fix.

2 / 3

Progressive Disclosure

References 'troubleshooting/messaging/' under an 'azure-diagnostics skill' but no bundle files are provided, meaning the referenced content doesn't exist. The skill essentially points to missing resources, making it a hollow shell. The References section just says to use a tool to search docs, which isn't progressive disclosure.

1 / 3

Total

6

/

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
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.