🎯

azure-messaging

🎯Skill

Helps you find and fix errors in apps that send and receive messages through Azure Event Hubs or Service Bus. It checks service health and Microsoft docs to suggest a fix.

microsoft/azure-skills688,126 Installs445Last Updated Mar 20, 2026

Installation

$npx skills add microsoft/azure-skills --skill azure-messaging

Run it in a terminal; it asks which AI coding tools to install it for (Claude Code, Codex, Cursor and more).

Uses skills.sh Β· Node.js 22.20+

After installing

Ask for related work and the agent uses it on its own, or call it yourself.

Run it (Claude Code)/azure-messaging
Install by hand

Copy the whole skill folder from GitHub to the place below. Copying only SKILL.md can leave out files the skill uses.

Open the skill folder β†’
  • This project .claude/skills/azure-messaging/
  • All projects ~/.claude/skills/azure-messaging/

These paths are for Claude Code. For other tools, the command above puts it in the right place.

What this skill does

Overview

This skill finds problems in the SDKs (official code libraries) for Azure Event Hubs and Service Bus, two Microsoft services that pass messages between apps. It covers connection failures, login errors and messages that stop being processed. It follows set steps: identify the SDK and version, check service health, read the error, search Microsoft Learn (Microsoft's official docs site), check settings and then recommend a fix.

Key Features

  • Fix connection drops, idle timeouts, slow reconnects and AMQP link errors (AMQP is the way these services send messages).
  • Solve lock problems, where the hold that reserves a message or session for processing expires or is lost.
  • Find out why message processing stops, why events arrive twice or why checkpoints (saved reading positions) reset.
  • Check your Event Hubs and Service Bus resources, service health and diagnostic logs with Azure MCP tools (tools Claude uses to read Azure information).
  • Get advice on retry, prefetch (loading messages ahead of time) and batch size settings, backed by Microsoft Learn docs.

Who is this for?

Use it when your Event Hubs or Service Bus app in Python, Java, JavaScript or .NET shows SDK errors. It also helps when messages stop arriving or get processed twice and you do not know why.

Summarized by AI from this skill's SKILL.md. Suggest a better one

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.

Azure Messaging SDK Troubleshooting

Quick Reference

PropertyValue
ServicesAzure Event Hubs, Azure Service Bus
MCP Toolsmcp_azure_mcp_eventhubs, mcp_azure_mcp_servicebus
Best ForDiagnosing SDK connection, auth, and message processing issues

When to Use This Skill

  • SDK connection failures, auth errors, or AMQP link errors
  • Idle timeout, connection inactivity, or slow reconnection after disconnect
  • AMQP link detach or detach-forced errors
  • Message lock lost, message lock expired, lock renewal failures, or batch lock timeouts
  • Session lock lost, session lock expired, or session receiver errors
  • Event processor or message handler stops processing
  • Duplicate events or checkpoint offset resets
  • SDK configuration questions (retry, prefetch, batch size, receive batch behavior)

MCP Tools

ToolCommandUse
mcp_azure_mcp_eventhubsNamespace/hub opsList namespaces, hubs, consumer groups
mcp_azure_mcp_servicebusQueue/topic opsList namespaces, queues, topics, subscriptions
mcp_azure_mcp_monitorlogs_queryQuery diagnostic logs with KQL
mcp_azure_mcp_resourcehealthgetCheck service health status
mcp_azure_mcp_documentationDoc searchSearch Microsoft Learn for troubleshooting docs

Diagnosis Workflow

  1. Identify the SDK and version β€” Check the prompt for SDK and version clues; if not stated, proceed with diagnosis and ask later if needed
  2. Check resource health β€” Use mcp_azure_mcp_resourcehealth to verify the namespace is healthy
  3. Review the error message β€” Match against language-specific troubleshooting guide
  4. Look up documentation β€” Use mcp_azure_mcp_documentation to search Microsoft Learn for the error or topic
  5. Check configuration β€” Verify connection string, entity name, consumer group
  6. Recommend fix β€” Apply remediation, citing documentation found

Troubleshooting Guides

Connectivity, SDK, and auth troubleshooting guides are located in the azure-diagnostics skill under troubleshooting/messaging/.

References

  • Use mcp_azure_mcp_documentation to search Microsoft Learn for latest guidance.

More from this repository10

🎯
microsoft-foundry🎯Skill

Helps you build, deploy, test, and manage AI agents and models on Microsoft Foundry, Microsoft's Azure service for AI. It guides the AI through each task with fixed steps.

🎯
azure-diagnostics🎯Skill

Helps you find and fix problems in apps running on Azure, such as crashes, slow responses, or connection failures. It checks things in a set order and can work only from logs you provide.

🎯
azure-prepare🎯Skill

azure-prepare gets a new or existing app ready to deploy to Azure with azd, Microsoft's command-line tool for Azure. It first writes a plan for your approval, then creates the setup files.

🎯
azure-deploy🎯Skill

azure-deploy puts your app on Azure after the azure-prepare and azure-validate skills have prepared and checked it. It runs the deployment, recovers from errors, and gives you the live web addresses.

🎯
azure-validate🎯Skill

azure-validate checks your Azure app before you deploy it, so you can catch setup and permission problems early. It runs after azure-prepare and before azure-deploy.

🎯
azure-resource-lookup🎯Skill

azure-resource-lookup finds and lists your Azure resources, such as web apps, virtual machines, and storage accounts, across your subscriptions. It only reads data and never changes anything.

🎯
azure-resource-visualizer🎯Skill

azure-resource-visualizer draws a diagram of an Azure resource group that shows how each resource connects to the others. It saves the diagram and notes in a markdown file.

🎯
azure-kusto🎯Skill

Lets Claude search and summarize large amounts of logs and app data stored in Azure Data Explorer. You ask what you want to know, and it writes and runs the queries for you.

🎯
azure-aigateway🎯Skill

Helps you send all requests to your AI models and tools through Azure API Management, so you can control cost, block harmful content and limit traffic. It includes Azure command-line steps for setup and testing.

🎯
azure-compute🎯Skill

A helper that sends your Azure virtual machine requests to the right step-by-step guide. It helps you choose, price, create and reserve cloud servers in Azure.