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.

53

Quality

58%

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 completeness. The explicit WHEN clause with extensive natural keywords makes it highly discoverable for relevant queries. The main weakness is that the 'what' portion could be more specific about concrete actions rather than listing categories of issues, though the trigger terms compensate significantly.

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 link detach 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' with an explicit 'WHEN:' clause containing extensive trigger terms. The when clause is comprehensive and well-structured.

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').

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche focused specifically on Azure Messaging SDKs (Event Hubs and Service Bus). The trigger terms are very specific to this domain (AMQP errors, event processor host, checkpoint, dead letter) and unlikely to conflict with general Azure skills or other messaging platform 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 is essentially a skeleton — it provides a reasonable organizational structure and identifies the right MCP tools, but contains almost no actionable content. There are no concrete error messages, no specific KQL queries, no code examples, and no actual troubleshooting steps. The references to external files in a non-existent bundle make the progressive disclosure worse than having everything inline.

Suggestions

Add concrete examples: include 2-3 common error messages (e.g., 'MessageLockLostException', 'OperationTimeoutException') with specific diagnostic steps and remediation code for at least one SDK language.

Include executable KQL queries for the `logs_query` tool, e.g., a query to check for AMQP connection failures or message lock expirations in diagnostic logs.

Either provide the referenced bundle files under 'troubleshooting/messaging/' or inline the most critical troubleshooting content (top 5 errors and fixes) directly in the SKILL.md.

Add a concrete worked example showing the full diagnosis workflow end-to-end for one common scenario (e.g., 'message lock lost' → check resource health → query logs → identify root cause → apply fix).

DimensionReasoningScore

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 slightly redundant with the quick reference table.

2 / 3

Actionability

No concrete code examples, no specific commands, no executable KQL queries, no actual error messages to match against, and no specific remediation steps. The workflow is entirely abstract — 'match against language-specific troubleshooting guide' and 'apply remediation' are vague directives with no concrete guidance.

1 / 3

Workflow Clarity

The 6-step diagnosis workflow provides a reasonable sequence, but lacks validation checkpoints, feedback loops for when diagnosis is inconclusive, and has no concrete examples of what each step actually looks like in practice. Steps like 'Review the error message — Match against language-specific troubleshooting guide' give no detail on how to do this.

2 / 3

Progressive Disclosure

References 'troubleshooting/messaging/' directory under an 'azure-diagnostics skill' but no bundle files are provided, making this a dead reference. The skill promises language-specific troubleshooting guides and detailed content that doesn't exist in the bundle, creating a hollow shell with no actual depth to disclose.

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.

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.