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

Quality

73%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.github/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 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.'

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

DimensionReasoningScore

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.

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.