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, 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.
79
73%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.github/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 completeness, explicitly separating the 'what' from the 'when'. The main weakness is that the capability description could be more specific about concrete actions rather than listing categories of issues. The extensive WHEN clause with natural user terms is a significant strength for skill selection.
Suggestions
Replace the categorical issue descriptions with more specific concrete actions, e.g., 'Diagnose AMQP connection failures, resolve message lock lost exceptions, configure checkpoint stores, analyze dead-letter queues, and enable SDK diagnostic logging.'
| 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 'resolve message lock lost exceptions'. 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, auth errors, message processing, SDK config) and 'when' with an explicit 'WHEN:' clause containing extensive trigger scenarios. The explicit trigger guidance is thorough. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would actually say, including specific error scenarios ('message lock lost', 'send timeout', 'receiver disconnected', 'event hub not receiving messages', 'service bus dead letter'), language-specific terms ('eventhub python', 'servicebus java', 'servicebus dotnet'), and common phrasing variations ('AMQP error', 'event processor host issue'). | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche focused specifically on Azure Messaging SDKs (Event Hubs and Service Bus). The combination of specific Azure services, SDK troubleshooting context, and detailed trigger terms like 'AMQP error', 'event processor host issue', and 'service bus dead letter' make it very unlikely to conflict with other skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
57%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-structured troubleshooting overview skill that excels at progressive disclosure and organization, pointing to language-specific SDK guides and service-level references appropriately. However, it lacks concrete executable examples (specific KQL queries, tool invocation patterns with parameters) and has some content redundancy across the References, Reference Index, and Connectivity Troubleshooting sections. The diagnostic workflow would benefit from explicit validation checkpoints and error-recovery branching.
Suggestions
Add a concrete example of a KQL query using `mcp_azure_mcp_monitor` `logs_query` for a common error scenario (e.g., connection failures or message lock lost)
Add feedback loops to the diagnosis workflow, e.g., 'If resource health shows degraded, check service status page before proceeding' and 'After applying fix, verify by re-running the failing operation'
Consolidate the 'Connectivity Troubleshooting', 'References', and 'Reference Index' sections to eliminate the triple-mention of service-troubleshooting.md
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient but has some redundancy — the 'References' section and 'Reference Index' section overlap with 'Connectivity Troubleshooting' which already links to service-troubleshooting.md. The 'When to Use This Skill' section partially duplicates the description. The Quick Reference table adds modest value but isn't padded. | 2 / 3 |
Actionability | Provides tool names and a diagnostic workflow with concrete steps, but lacks executable code examples, specific KQL queries for log analysis, or concrete command invocations showing exact parameters. The guidance is structured but remains at the 'what to do' level rather than 'exactly how to do it' level. | 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, try that' branching, and no verification step to confirm the fix worked. For a troubleshooting skill involving potentially destructive operations (configuration changes), this is a gap. | 2 / 3 |
Progressive Disclosure | Excellent progressive disclosure with a clear overview, well-organized SDK-specific references by language, a reference index with explicit 'when to load' guidance, and one-level-deep links to detailed materials. The instruction to load on demand is a nice touch. | 3 / 3 |
Total | 9 / 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.
ec7b8ff
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.