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
58%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.github/plugins/azure-skills/skills/azure-messaging/SKILL.mdQuality
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'.
| Dimension | Reasoning | Score |
|---|---|---|
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
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
d02fd24
Table of Contents
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.