azure-messaging Skill for Claude: Troubleshoot Event Hubs and Service Bus SDKs

Helps Claude diagnose Azure Event Hubs and Service Bus SDK problems such as lost locks, link detaches and stalled consumers.

Installs: 563.7K; on skills.sh
Stars: 1.6K; on GitHub
Updated: Oct 2026; last repo commit

azure-messaging gives Claude a six-step routine for Event Hubs and Service Bus SDK problems. It covers connection failures, auth errors, message lock lost or expired, AMQP link detach, idle timeouts, duplicate events and checkpoint resets. It also answers SDK settings questions on retry, prefetch and batch size.

The skill itself is one short file. Its troubleshooting guides live in the azure-diagnostics skill under troubleshooting/messaging/, so install that one too. Claude checks resource health and searches Microsoft Learn through the Azure MCP server.

Good for

Developers debugging Event Hubs or Service Bus client code
Backend engineers with consumers that stall or reprocess messages
Ops teams chasing connection and auth errors

Install azure-messaging

Claude Code

Copy this prompt.

Install the azure-messaging skill in Claude Code. Run this command:

/plugin install azure@claude-plugins-official

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Azure CLI signed in.

Pick one route, not both. The plugin installs all the Azure skills and wires in the Azure and Foundry tool servers they call. The skills CLI route installs only the skills named in the command, and does not wire in the Azure or Foundry tool servers, so enable the Azure MCP server separately if you want the tools the skills call. Sign in with az login first. azure-messaging needs azure-diagnostics from the same repo, so the CLI command names them all.

From the project README. Source.

What's in the skill

When it loads

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.

Sections in SKILL.md

Quick Reference
When to Use This Skill
MCP Tools
Diagnosis Workflow
Troubleshooting Guides
References

Key facts

Author: Microsoft
License: MIT (stated in SKILL.md)
GitHub stars: 1,609 for the whole microsoft/azure-skills repo (Nov 2, 2026)
Last commit: Oct 30, 2026
What installs: SKILL.md only; bundles no other files
Needs: azure-diagnostics (holds the guides); the Azure MCP server
Part of: The azure plugin in microsoft/azure-skills
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk pass
Works in: GitHub Copilot, Claude Code, Cursor, Codex, Gemini CLI, OpenCode (plugin README)

What it includes

Works out the SDK, language and version from your prompt
1. Identify the SDK
Looks up the namespace health in Azure
Uses the Azure MCP resourcehealth tool.
Network · 2. Check resource health
Compares your error with the language-specific guide
Guides live in the azure-diagnostics skill.
Read · 3. Match the error
Searches Microsoft Learn for the error
Uses the Azure MCP documentation tool.
Network · 4. Look up documentation
Verifies connection string, entity name and consumer group
Read · 5. Check configuration
Proposes a fix with documentation cited
6. Recommend a fix
Queries diagnostic logs with KQL
Uses the Azure MCP monitor logs_query tool.
Network · Log queries

From the official docs

Permissions

Low risk

Claude lists namespaces and reads health and logs. Share endpoint and entity names, not connection strings that contain keys.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

Do not paste keyed connection strings
Claude may ask you to check your connection string. Share names and endpoints, not account keys.
Diagnosis only
The tools it names list resources, read health and logs, and search docs.

Technical details

Scopes	Lists Event Hubs and Service Bus namespaces, queues and topics Queries diagnostic logs Uses the Azure MCP server and your sign-in

Questions

What does azure-messaging do?

It helps Claude diagnose Azure Event Hubs and Service Bus SDK problems, such as connection failures, expired message locks, AMQP link detach and duplicate events.

How do I install it?

Use the install box at the top of this page. In Claude Code the plugin command installs the Azure skills together with the Azure tools they call, so pick it unless you want this one skill only. Run az login before you start.

Why does it need azure-diagnostics?

The SKILL.md says its connectivity, SDK and auth troubleshooting guides are in azure-diagnostics under troubleshooting/messaging/. The install box adds both.

Which languages does it cover?

Its trigger list names Python, Java, JavaScript and .NET SDKs for Event Hubs and Service Bus.

Is it safe?

It diagnoses and does not set out to change resources. skills.sh lists Gen Agent Trust Hub, Socket and Snyk as pass.

Does it cover Storage queues?

No. Its scope is Event Hubs and Service Bus SDK problems. The azure-storage skill covers Queue Storage and sends Event Hubs and Service Bus questions here.

Does it work in the Claude app, Codex or Cursor?

The Azure README lists GitHub Copilot, Claude Code, Cursor, Codex, Gemini CLI and OpenCode as hosts for the plugin. It does not list the Claude desktop or web app.

Information

updated Nov 2, 2026

Repository: microsoft/azure-skills
Folder: skills/azure-messaging

microsoft/azure-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 3

microsoft/azure-skills README · github.com
azure-messaging SKILL.md · github.com
azure-messaging on skills.sh · skills.sh