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.

67

Quality

58%

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 ./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 for Azure Messaging SDK troubleshooting. The explicit 'WHEN:' clause with extensive trigger terms ensures Claude can reliably select this skill. The main weakness is that the 'what' portion describes categories of issues rather than specific concrete actions the skill performs (e.g., 'diagnose', 'resolve', 'configure').

Suggestions

Strengthen the specificity by listing concrete actions rather than issue categories, e.g., 'Diagnoses AMQP connection errors, resolves message lock expiration, configures checkpoint stores, enables SDK diagnostic logging' instead of 'Covers connection failures, authentication errors, message processing issues'.

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 Azure Messaging SDK issues for Event Hubs and Service Bus, covering connection failures, auth errors, message processing, SDK config) and 'when' with an explicit 'WHEN:' clause followed by an extensive list of trigger scenarios.

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 — narrowly scoped to Azure Messaging SDKs (Event Hubs and Service Bus) troubleshooting specifically. The trigger terms are very domain-specific (AMQP, event processor host, checkpoint, dead letter, session lock) and unlikely to conflict with other 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 that lists tools and a generic workflow but provides no substantive troubleshooting content. It lacks concrete error-to-fix mappings, executable code/queries, and specific remediation steps — instead deferring everything to external documentation searches and missing bundle files. The skill tells Claude to 'look things up' rather than teaching it how to solve problems.

Suggestions

Add concrete error-to-fix mappings for the most common issues (e.g., 'Message lock lost' → specific remediation with code examples for each SDK language)

Include ready-to-use KQL queries for the `logs_query` tool to diagnose common issues like connection failures, idle timeouts, and dead-lettered messages

Either include the referenced 'troubleshooting/messaging/' files in the bundle or inline the key troubleshooting patterns directly in the SKILL.md

Add specific configuration examples (e.g., retry policy settings, prefetch count recommendations, lock duration values) rather than just saying 'verify connection string, entity name, consumer group'

DimensionReasoningScore

Conciseness

Mostly efficient with good use of tables, but the 'When to Use This Skill' section is somewhat redundant with the description/frontmatter triggers, and the content is lean enough overall but doesn't add much substance to justify its length.

2 / 3

Actionability

The skill provides no concrete code, commands, KQL queries, or specific error-to-fix mappings. The diagnosis workflow is a generic sequence of abstract steps ('Check configuration', 'Recommend fix') without executable examples or specific remediation patterns. It essentially says 'look it up' rather than providing actionable guidance.

1 / 3

Workflow Clarity

The diagnosis workflow has a clear 6-step sequence, but lacks validation checkpoints, feedback loops for when fixes don't work, and doesn't specify what to do when resource health is unhealthy vs healthy. No error recovery or branching logic is provided.

2 / 3

Progressive Disclosure

References 'troubleshooting/messaging/' under an azure-diagnostics skill but no bundle files are provided, making this a dead reference. The skill essentially defers all substantive content to external files that don't exist in the bundle, leaving the SKILL.md as a hollow shell with no real content to disclose progressively.

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.