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.
85
81%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
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 issue categories.
Suggestions
Strengthen specificity by listing concrete actions like 'diagnose AMQP connection errors, configure checkpoint stores, resolve dead-letter queue issues, enable SDK diagnostic logging' instead of broad categories like 'connection failures, 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 errors' 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 scenarios ('event hub not receiving messages', 'service bus dead letter', 'duplicate events', 'offset reset'). 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 errors, event processor host, message lock, checkpoint, dead letter) and unlikely to conflict with other skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-organized hub/overview skill that efficiently directs Claude to the right reference materials based on the problem type. Its main weakness is the lack of concrete, inline actionable content—there are no example KQL queries, no specific error-to-resolution mappings, and no executable code snippets in the main file. The diagnosis workflow would benefit from explicit validation steps and error recovery branching.
Suggestions
Add 1-2 concrete KQL query examples for common diagnostic scenarios (e.g., querying for connection failures or message lock expirations) to make the diagnosis workflow immediately actionable.
Add a feedback loop to the diagnosis workflow, e.g., 'After applying fix, verify resolution by re-checking resource health and confirming message flow resumes' to strengthen validation.
Include a small inline table mapping the most common error messages (e.g., 'MessageLockLostException', 'OperationTimeoutException') to their quick fixes, so Claude doesn't always need to consult reference files for frequent issues.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and well-structured. It avoids explaining what Azure Event Hubs or Service Bus are, assumes Claude's competence, and every section serves a clear purpose. The tables are efficient information delivery. | 3 / 3 |
Actionability | The skill provides specific MCP tool names and a diagnosis workflow, but lacks concrete executable examples—no KQL queries, no example connection string validation commands, no specific error-to-fix mappings. The actionable details are deferred to reference files. | 2 / 3 |
Workflow Clarity | The 6-step diagnosis workflow is clearly sequenced and logical, but lacks explicit validation checkpoints or feedback loops. There's no 'if this fails, do X' branching or verification that a fix actually resolved the issue before closing out. | 2 / 3 |
Progressive Disclosure | Excellent progressive disclosure structure: concise overview with well-signaled, one-level-deep references to 8 SDK-specific guides and a service troubleshooting guide. Navigation is clear with organized links by service and language. | 3 / 3 |
Total | 10 / 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.
a46a937
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.