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.

63

Quality

73%

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 ./plugin/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 relevant queries. The main weakness is that the 'what' portion could be more specific about concrete actions rather than listing categories of issues.

Suggestions

Enhance specificity by listing concrete actions like 'diagnose AMQP connection errors, resolve checkpoint store issues, configure dead letter queues, debug message lock expiration' instead of generic categories like 'connection failures, 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 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 explicit trigger guidance.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would actually say, including specific error conditions ('message lock lost', 'lock expired', 'send timeout', 'receiver disconnected'), SDK-language combinations ('eventhub python', 'servicebus java'), and common symptoms ('not receiving messages', '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 combination of Azure-specific terms, AMQP protocol references, and SDK-language pairs makes 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.

The skill is well-organized and concise, with good use of tables for quick reference and a clear scope definition. However, it lacks concrete actionable content — no specific error-to-resolution mappings, no example KQL queries, no code snippets for common fixes. The referenced troubleshooting guides in 'troubleshooting/messaging/' are not provided in the bundle, making the progressive disclosure structure hollow.

Suggestions

Add concrete examples: include 2-3 common error messages with specific KQL queries to diagnose them and exact remediation steps (e.g., message lock expired → increase lock duration, add lock renewal code snippet)

Provide the referenced troubleshooting guide files in the bundle (e.g., troubleshooting/messaging/event-hubs.md, troubleshooting/messaging/service-bus.md) or inline the most critical troubleshooting patterns

Add validation checkpoints to the diagnosis workflow, such as 'If resource health shows degraded, stop and escalate' or 'If connection string validates but connection still fails, check network/firewall rules'

Include at least one executable KQL query example for the mcp_azure_mcp_monitor logs_query tool to make the diagnostic workflow actionable

DimensionReasoningScore

Conciseness

The content is lean and well-structured with tables for quick reference. It avoids explaining what Event Hubs or Service Bus are, assumes Claude's competence, and every section serves a clear purpose.

3 / 3

Actionability

The skill lists MCP tools and a diagnosis workflow, but lacks concrete executable examples — no KQL queries, no sample connection string validation commands, no specific error-to-fix mappings. The troubleshooting guides are referenced but not provided, and the workflow steps are high-level directions rather than copy-paste ready instructions.

2 / 3

Workflow Clarity

The 6-step diagnosis workflow provides a reasonable sequence, but lacks validation checkpoints and feedback loops. There's no explicit 'if this fails, do that' recovery path, and the final step ('Apply remediation, citing documentation found') is vague. For a troubleshooting skill involving potentially destructive operations like message processing, more explicit verification steps are needed.

2 / 3

Progressive Disclosure

The skill references 'troubleshooting/messaging/' under an azure-diagnostics skill but no bundle files are provided, making this a dead reference. There are no actual linked files for the troubleshooting guides, language-specific guides, or examples. The progressive disclosure structure is promised but not delivered.

1 / 3

Total

8

/

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/github-copilot-for-azure
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.