About azure-notification-hubs
azure-notification-hubs is an Agent skill for developers and operators working with Azure Notification Hubs. It combines local reference content with fetched documentation covering push design, troubleshooting, configuration, security, integrations, and deployment.
Key features
- 01Push notification troubleshooting
- 02Registration, tags, and templates
- 03Architecture, limits, and quotas
- 04Security and service configuration
- 05SDK, REST, and deployment guidance
Use cases
- 01Tracing dropped push notifications
- 02Designing targeted, multi-tenant push
- 03Configuring platform push credentials
- 04Planning regional migration
MCP support
The skill can fetch documentation through mcp_microsoftdocs:microsoft_docs_fetch; it also documents a webpage-fetch fallback.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-notification-hubsAfter installing, type/azure-notification-hubsin Claude Code to confirm it loaded.
Details
From the project READMEAzure Notification Hubs Skill
This skill provides expert guidance for Azure Notification Hubs. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. 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 | L37-L41 | Diagnosing and fixing common Notification Hubs issues, including delivery failures, dropped notifications, platform-specific errors, and steps to trace, test, and resolve send problems. |
| Best Practices | L42-L49 | Designing Notification Hubs solutions, choosing registration patterns, using tags/routing, and creating templates for efficient, targeted push notifications. |
| Decision Making | L50-L54 | Guidance on choosing and switching Notification Hubs pricing tiers, comparing feature limits, scale, and cost implications for different workloads. |
| Architecture & Design Patterns | L55-L59 | Guidance on designing large-scale, multi-tenant, and geo-distributed push notification architectures with Azure Notification Hubs, including patterns, best practices, and integration approaches. |
| Limits & Quotas | L60-L64 | Notification Hubs limits, quotas, and throttling behaviors, plus how to create, manage, and understand constraints of scheduled push notifications. |
| Security | L65-L73 | Security, encryption, TLS, and network isolation for Notification Hubs: data-at-rest encryption, EU data boundary, SAS/role-based access, TLS version planning, and Private Link setup. |
| Configuration | L74-L94 | Configuring Notification Hubs (PNS credentials for APNS/FCM/WNS/MPNS/Baidu), IaC setup (Bicep/ARM/Terraform), and monitoring/automation via metrics, logs, and PowerShell. |
| Integrations & Coding Patterns | L95-L121 | Implementing and migrating push notification integrations (FCM v1, APNS, WNS), device/user targeting, templates, localization, and using REST/SDKs (Java, PHP, Python, UWP, Android, iOS). |
| Deployment | L122-L125 | Guidance on safely migrating Notification Hubs across Azure regions, including planning, data preservation, and minimizing downtime during region moves. |
Troubleshooting
| Topic | URL |
|---|---|
| Diagnose and fix dropped notifications in Notification Hubs | https://learn.microsoft.com/en-us/azure/notification-hubs/notification-hubs-push-notification-fixer |
Best Practices
| Topic | URL |
|---|---|
| Design and implement solutions with Azure Notification Hubs | https://learn.microsoft.com/en-us/azure/notification-hubs/notification-hubs-push-notification-faq |
| Choose registration patterns for Azure Notification Hubs | https://learn.microsoft.com/en-us/azure/notification-hubs/notification-hubs-push-notification-registration-management |
| Use tags and routing expressions in Azure Notification Hubs | https://learn.microsoft.com/en-us/azure/notification-hubs/notification-hubs-tags-segment-push-message |
| Design and use Notification Hubs templates for push | https://learn.microsoft.com/en-us/azure/notification-hubs/notification-hubs-templates-cross-platform-push-messages |
Decision Making
| Topic | URL |
|---|---|
| Select and change Azure Notification Hubs pricing tiers | https://learn.microsoft.com/en-us/azure/notification-hubs/change-pricing-tier |
Architecture & Design Patterns
| Topic | URL |
|---|---|
| Design enterprise push architectures with Notification Hubs | https://learn.microsoft.com/en-us/azure/notification-hubs/notification-hubs-enterprise-push-notification-architecture |
Limits & Quotas
| Topic | URL |
|---|---|
| Use scheduled notifications in Notification Hubs | https://learn.microsoft.com/en-us/azure/notification-hubs/notification-hubs-send-push-notifications-scheduled |
Security
| Topic | URL |
|---|---|
| Azure Notification Hubs data-at-rest encryption details | https://learn.microsoft.com/en-us/azure/notification-hubs/encrypt-at-rest |
| Understand EU Data Boundary behavior in Notification Hubs | https://learn.microsoft.com/en-us/azure/notification-hubs/eu-data-boundary |
| Apply Notification Hubs security model and access rules | https://learn.microsoft.com/en-us/azure/notification-hubs/notification-hubs-push-notification-security |
| Plan for TLS version support in Azure Notification Hubs | https://learn.microsoft.com/en-us/azure/notification-hubs/notification-hubs-tls12 |
| Configure Private Link for Azure Notification Hubs | https://learn.microsoft.com/en-us/azure/notification-hubs/private-link |
Configuration
Integrations & Coding Patterns
Deployment
| Topic | URL |
|---|---|
| Move Azure Notification Hubs between regions safely | https://learn.microsoft.com/en-us/azure/notification-hubs/move-registrations |