azure-event-grid skill
✓ OfficialProvides expert guidance for developing, configuring, and securing Azure Event Grid topics, namespaces, and MQTT brokers.
- GitHub stars
- 811
- Files
- 1
- Last commit
- Nov 9, 2026
- License
- CC-BY-4.0
- Allowed tools
- —
What does the azure-event-grid skill do?
azure-event-grid provides expert guidance for developing, configuring, and securing Azure Event Grid topics, namespaces, and MQTT brokers.
Summary generated from the skill's SKILL.md.
About the azure-event-grid skill
Developers building event-driven architectures can use this skill to receive expert guidance on Azure Event Grid topics, namespaces, and MQTT brokers. It assists with complex tasks such as designing MQTT topic hierarchies, implementing request-response flows, and configuring secure webhook handlers. The skill is specifically designed for Event Grid development and should not be used for Azure Service Bus, Event Hubs, or Azure Functions.
When an agent loads this skill, it can access local reference content or fetch live documentation using mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage. This allows for detailed troubleshooting of error codes, network connectivity issues, and webhook validation failures. It also provides technical details on security implementations like managed identities, RBAC, private endpoints, and JWT authentication for MQTT clients.
What an agent can do with it
- 1Troubleshoot MQTT broker issuesDiagnose connectivity or error code problems within an Azure Event Grid MQTT broker.
- 2Design MQTT architecturesCreate structured MQTT topic hierarchies and command-response patterns for event routing.
- 3Secure event deliveryImplement authentication and network security using managed identities, private endpoints, or IP firewalls.
- 4Evaluate service tiersCompare different Event Grid tiers and hosting options like Kubernetes versus Azure native services.
Written from the skill's SKILL.md. Every use case is checked against a quote from it.
How to install the azure-event-grid skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the azure-event-grid skill in Claude Code
~/.claude/skills/azure-event-grid/SKILL.md
$ npx degit MicrosoftDocs/Agent-Skills/skills/azure-event-grid ~/.claude/skills/azure-event-gridInstall the azure-event-grid skill in Claude Code (project)
.claude/skills/azure-event-grid/SKILL.md
$ npx degit MicrosoftDocs/Agent-Skills/skills/azure-event-grid .claude/skills/azure-event-gridInstall the azure-event-grid skill in Codex
~/.agents/skills/azure-event-grid/SKILL.md
$ npx degit MicrosoftDocs/Agent-Skills/skills/azure-event-grid ~/.agents/skills/azure-event-gridInstall the azure-event-grid skill in Gemini CLI
~/.gemini/skills/azure-event-grid/SKILL.md
$ npx degit MicrosoftDocs/Agent-Skills/skills/azure-event-grid ~/.gemini/skills/azure-event-gridInstall the azure-event-grid skill in Claude.ai
npx degit MicrosoftDocs/Agent-Skills/skills/azure-event-grid azure-event-grid && zip -r azure-event-grid.zip azure-event-grid # claude.ai → Customize → Skills → + → Create skill → Upload a skill → azure-event-grid.zip
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A skill needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablemicrosoftdocs/agent-skills/skills/azure-event-grid is public and reachablegithub.com/microsoftdocs/agent-skills/tree/HEAD/skills/azure ↗Pass
- Open source license (OSI)CC-BY-4.0 is not OSI-approvedspdx.org/licenses/CC-BY-4.0.html ↗Finding
- Commit or release in the last yearLast commit 2026-11-09github.com/microsoftdocs/agent-skills/commits ↗Pass
- No download-and-run or credential theft in scriptsNo scripts in the skill folderPass
- No hidden instructions in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/microsoftdocs/agent-skills/blob/HEAD/skills/azure ↗Pass
- Pre-approved tools are scopedNo pre-approved tools; the agent asks before using onegithub.com/microsoftdocs/agent-skills/blob/HEAD/skills/azure ↗Pass
- SKILL.md follows the Agent Skills formatValid name and description; says when to use it; 244 linesgithub.com/microsoftdocs/agent-skills/blob/HEAD/skills/azure ↗Pass
SKILL.md
View on GitHubAzure Event Grid Skill
This skill provides expert guidance for Azure Event Grid. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, and integrations & coding patterns. It combines local quick-reference content with remote documentation fetching capabilities.
How to Use This Skill
IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g.,
L35-L120), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: If
metadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools are not available, suggest the user install it: Installation Guide
This skill requires network access to fetch documentation content:
- Preferred: Use
mcp_microsoftdocs:microsoft_docs_fetchwith query stringfrom=learn-agent-skill. Returns Markdown. - Fallback: Use
fetch_webpagewith query stringfrom=learn-agent-skill&accept=text/markdown. Returns Markdown.
Category Index
| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L36-L44 | Diagnosing and fixing Event Grid issues: MQTT broker problems, error codes, common failures, network connectivity, and webhook subscription validation errors. |
| Best Practices | L45-L49 | Guidance on designing client-side failover for Event Grid, including using multiple regions, retry logic, and resilient publishing patterns for high availability. |
| Decision Making | L50-L60 | Guidance for choosing Event Grid tiers, schemas, Kubernetes vs Azure hosting, MQTT routing, autoscale, push delivery, and migration from Event Grid on IoT Edge to IoT Edge hub. |
| Architecture & Design Patterns | L61-L67 | Patterns for routing events between namespaces, designing MQTT topic hierarchies, and implementing MQTT command/response flows using Azure Event Grid. |
| Limits & Quotas | L68-L79 | Event Grid delivery/retry behavior, custom headers, event retention, and region-specific quotas/limits for topics, namespaces, and Kubernetes-based Event Grid |
| Security | L80-L129 | Securing Event Grid: auth for publishers/handlers/MQTT, managed identities/RBAC, keys/SAS/JWT/webhooks, IP firewalls, private endpoints, TLS, network perimeters, and compliance policies. |
| Configuration | L130-L203 | Configuring Event Grid and namespaces: topics, schemas, filters, monitoring, TLS, autoscale, MQTT/HTTP clients, ACS/AKS/IoT/Graph sources, and subscription/dead-letter settings. |
| Integrations & Coding Patterns | L204-L244 | Patterns and guides for integrating Event Grid with Auth0, Graph/M365 apps, MQTT, webhooks, Functions, Service Bus, Event Hubs, and understanding event schemas and handler configuration. |
Troubleshooting
| Topic | URL |
|---|---|
| Troubleshoot Azure Event Grid MQTT broker issues | https://learn.microsoft.com/en-us/azure/event-grid/mqtt-troubleshoot-errors |
| Azure Event Grid error codes and resolutions | https://learn.microsoft.com/en-us/azure/event-grid/troubleshoot-errors |
| Troubleshoot common Azure Event Grid issues | https://learn.microsoft.com/en-us/azure/event-grid/troubleshoot-issues |
| Diagnose Azure Event Grid network connectivity failures | https://learn.microsoft.com/en-us/azure/event-grid/troubleshoot-network-connectivity |
| Troubleshoot Event Grid webhook subscription validation | https://learn.microsoft.com/en-us/azure/event-grid/troubleshoot-subscription-validation |
Best Practices
| Topic | URL |
|---|---|
| Implement client-side failover for Azure Event Grid | https://learn.microsoft.com/en-us/azure/event-grid/custom-disaster-recovery-client-side |
Decision Making
| Topic | URL |
|---|---|
| Select the right Azure Event Grid tier | https://learn.microsoft.com/en-us/azure/event-grid/choose-right-tier |
| Choose compatible event schemas for Azure Event Grid subscriptions | https://learn.microsoft.com/en-us/azure/event-grid/event-schema-compatibility |
| Compare Event Grid on Kubernetes vs Azure features | https://learn.microsoft.com/en-us/azure/event-grid/kubernetes/features |
| Choose MQTT routing options in Event Grid | https://learn.microsoft.com/en-us/azure/event-grid/mqtt-routing |
| Use Autoscale for Azure Event Grid namespaces | https://learn.microsoft.com/en-us/azure/event-grid/namespace-autoscale-overview |
| Decide on push delivery for Event Grid namespaces | https://learn.microsoft.com/en-us/azure/event-grid/namespace-push-delivery-overview |
| Migrate from Event Grid on IoT Edge to IoT Edge hub | https://learn.microsoft.com/en-us/azure/event-grid/transition |
Architecture & Design Patterns
| Topic | URL |
|---|---|
| Forward events between Event Grid namespace topics | https://learn.microsoft.com/en-us/azure/event-grid/forward-events-to-another-namespace-topic |
| Implement MQTT request-response commands with Event Grid | https://learn.microsoft.com/en-us/azure/event-grid/mqtt-request-response-messages |
| Design MQTT topic spaces in Event Grid | https://learn.microsoft.com/en-us/azure/event-grid/mqtt-topic-spaces |
Limits & Quotas
Security
Configuration
Files in this skill
1azure-event-grid skill questions
How do I install the azure-event-grid skill in Claude Code?
Run npx degit MicrosoftDocs/Agent-Skills/skills/azure-event-grid ~/.claude/skills/azure-event-grid. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the azure-event-grid skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.
What topics does this skill cover for Azure Event Grid?
The skill covers troubleshooting, best practices, decision making, architecture, design patterns, limits, quotas, security, configuration, and integrations.
Can I use this skill for Azure Service Bus?
No, this skill is specifically for Azure Event Grid; for Azure Service Bus, you should use the azure-service-bus skill.