azure-expressroute

Name: azure-expressroute
Author: microsoftdocs

github.com/microsoftdocsCloud & DevOps796176 installsUpdated 3d ago

About azure-expressroute

azure-expressroute is a guidance skill for agents working with Azure ExpressRoute. It combines local reference material with remote documentation retrieval covering network design, configuration, troubleshooting, security, and deployment.

Key features

01Connectivity and routing troubleshooting
02Capacity, QoS, and resiliency practices
03Gateway and topology selection guidance
04Limits, quotas, and security references
05Local references and remote docs

Use cases

01Diagnose asymmetric routing and link failures
02Plan highly available or disaster recovery networks
03Configure ExpressRoute circuits and gateways

MCP support

The skill can retrieve remote documentation through mcp_microsoftdocs:microsoft_docs_fetch; it is not described as an MCP server.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-expressroute

After installing, type/azure-expressroutein Claude Code to confirm it loaded.

Details

From the project README

Azure ExpressRoute Skill

This skill provides expert guidance for Azure ExpressRoute. 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), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools 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_fetch with query string from=learn-agent-skill. Returns Markdown.
Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

Category	Lines	Description
Troubleshooting	L37-L42	Troubleshooting ExpressRoute resiliency and asymmetric routing issues, plus FAQs on connectivity models, supported services, bandwidth, and pricing to resolve design or outage-related questions.
Best Practices	L43-L53	Best practices for ExpressRoute capacity planning, QoS, BGP communities, gateway hardware migration, and validating resiliency via gateway and circuit failover testing.
Decision Making	L54-L62	Guidance on choosing and configuring ExpressRoute gateways, SKUs, resiliency/topology options, VNet connectivity patterns, and planning/managing ExpressRoute-related costs.
Architecture & Design Patterns	L63-L74	Designing resilient, highly available ExpressRoute architectures, including DR patterns, multi-circuit routing/Global Reach, VPN coexistence and failover, and using Microsoft peering for PSTN.
Limits & Quotas	L75-L84	ExpressRoute bandwidth, route, and gateway limits; FastPath usage; provider rate limiting; monitoring advertised routes; and FAQs on staying within connectivity quotas.
Security	L85-L93	Encryption and security for ExpressRoute: IPsec/MACsec setup, NAT requirements, RBAC roles/permissions, and applying network security controls to private circuits.
Configuration	L94-L122	Configuring ExpressRoute circuits, gateways, routing/peering, BGP (incl. IPv6, communities, BFD), NAT, monitoring, resiliency, and coexistence with VPN using portal, CLI, and PowerShell
Integrations & Coding Patterns	L123-L130	Configuring and automating ExpressRoute circuits and connectivity, including Azure CLI management, NAT setups for Cisco/Juniper, and S2S VPN over Microsoft peering.
Deployment	L131-L138	Guides for deploying and migrating ExpressRoute circuits/gateways, including Direct SKUs, zone/AZ-enabled gateways, and ARM/Terraform-based provisioning and traffic migration.

Troubleshooting

Topic	URL
Test and validate resiliency of redundant ExpressRoute circuits	https://learn.microsoft.com/en-us/azure/expressroute/evaluate-circuit-resiliency
Diagnose and resolve asymmetric routing with ExpressRoute	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-asymmetric-routing

Best Practices

Topic	URL
Apply best practices for ExpressRoute bandwidth upgrades	https://learn.microsoft.com/en-us/azure/expressroute/about-upgrade-circuit-bandwidth
Manage complex ExpressRoute networks using BGP communities	https://learn.microsoft.com/en-us/azure/expressroute/bgp-communities
Apply QoS requirements for Skype voice over ExpressRoute	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-qos
Migrate legacy ExpressRoute gateway connections to new hardware	https://learn.microsoft.com/en-us/azure/expressroute/howto-recreate-connections
Use Resiliency Insights to harden ExpressRoute gateways	https://learn.microsoft.com/en-us/azure/expressroute/resiliency-insights
Validate ExpressRoute gateway resiliency with failover tests	https://learn.microsoft.com/en-us/azure/expressroute/resiliency-validation
Test and validate Azure ExpressRoute link failover	https://learn.microsoft.com/en-us/azure/expressroute/test-link-failover

Decision Making

Topic	URL
Select and configure ExpressRoute virtual network gateways	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-about-virtual-network-gateways
Plan and execute ExpressRoute gateway SKU migration	https://learn.microsoft.com/en-us/azure/expressroute/gateway-migration
Plan and manage Azure ExpressRoute costs	https://learn.microsoft.com/en-us/azure/expressroute/plan-manage-cost
Select ExpressRoute gateway resiliency configuration	https://learn.microsoft.com/en-us/azure/expressroute/resiliency-model
Choose VNet connectivity options over ExpressRoute	https://learn.microsoft.com/en-us/azure/expressroute/virtual-network-connectivity-guidance

Architecture & Design Patterns

Topic	URL
Design resilient Azure ExpressRoute network architectures	https://learn.microsoft.com/en-us/azure/expressroute/design-architecture-for-resiliency
Design disaster recovery with Azure ExpressRoute	https://learn.microsoft.com/en-us/azure/expressroute/designing-for-disaster-recovery-with-expressroute-privatepeering
Architect high availability for Azure ExpressRoute	https://learn.microsoft.com/en-us/azure/expressroute/designing-for-high-availability-with-expressroute
Connect multiple ExpressRoute circuits with Global Reach	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-global-reach
Optimize routing across multiple ExpressRoute circuits	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-optimize-routing
Architect coexisting ExpressRoute and S2S VPN connections	https://learn.microsoft.com/en-us/azure/expressroute/how-to-configure-coexisting-gateway-portal
Design S2S VPN backup for ExpressRoute private peering	https://learn.microsoft.com/en-us/azure/expressroute/use-s2s-vpn-as-backup-for-expressroute-privatepeering
Use ExpressRoute Microsoft peering for PSTN services	https://learn.microsoft.com/en-us/azure/expressroute/using-expressroute-for-microsoft-pstn

Limits & Quotas

Topic	URL
Evaluate Azure ExpressRoute FastPath limits and usage	https://learn.microsoft.com/en-us/azure/expressroute/about-fastpath
Manage ExpressRoute advertised route scale within limits	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-connection-manage-advertised-routes
Azure ExpressRoute FAQs on limits and connectivity details	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-faqs
Monitor ExpressRoute advertised routes to avoid limits	https://learn.microsoft.com/en-us/azure/expressroute/how-to-custom-route-alert
Understand rate limiting on provider-based ExpressRoute circuits	https://learn.microsoft.com/en-us/azure/expressroute/provider-rate-limit
ExpressRoute scalable gateway features and limits	https://learn.microsoft.com/en-us/azure/expressroute/scalable-gateway

Security

Topic	URL
Use encryption options with Azure ExpressRoute	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-about-encryption
Configure IPsec transport mode over ExpressRoute for Windows	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-howto-ipsec-transport-private-windows
Configure MACsec security for Azure ExpressRoute	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-howto-macsec
Roles and permissions for ExpressRoute resources	https://learn.microsoft.com/en-us/azure/expressroute/roles-permissions
Apply security controls to Azure ExpressRoute	https://learn.microsoft.com/en-us/azure/expressroute/secure-expressroute

Configuration

Topic	URL
Configure customer-controlled maintenance windows for ExpressRoute gateways	https://learn.microsoft.com/en-us/azure/expressroute/customer-controlled-gateway-maintenance
Configure BFD settings for Azure ExpressRoute private peering	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-bfd
Configure on-premises routers for Azure ExpressRoute	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-config-samples-routing
Configure IPv6 private peering for Azure ExpressRoute	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-howto-add-ipv6
Configure coexisting ExpressRoute and S2S VPN connections (classic)	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-howto-coexist-classic
Configure coexisting ExpressRoute and S2S VPN gateways	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-howto-coexist-resource-manager
Connect VNets to ExpressRoute circuits with PowerShell	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-howto-linkvnet-arm
Link Azure VNets to ExpressRoute circuits via CLI	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-howto-linkvnet-cli
Reset ExpressRoute circuit peerings with PowerShell	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-howto-reset-peering
Reset ExpressRoute circuit peerings in Azure portal	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-howto-reset-peering-portal
Configure ExpressRoute routing and peering with PowerShell	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-howto-routing-arm
Configure ExpressRoute peering in Azure portal	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-howto-routing-portal-resource-manager
Configure a scalable ExpressRoute gateway in portal	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-howto-scalable-portal
Configure ExpressRoute Global Reach with PowerShell	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-howto-set-global-reach
Configure ExpressRoute Global Reach in Azure portal	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-howto-set-global-reach-portal
Configure NAT requirements for Azure ExpressRoute circuits	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-nat
Configure Connection Monitor for ExpressRoute connectivity	https://learn.microsoft.com/en-us/azure/expressroute/how-to-configure-connection-monitor
Configure custom BGP communities for ExpressRoute private peering	https://learn.microsoft.com/en-us/azure/expressroute/how-to-configure-custom-bgp-communities
Configure custom BGP community values for ExpressRoute	https://learn.microsoft.com/en-us/azure/expressroute/how-to-configure-custom-bgp-communities-portal
Configure ExpressRoute Traffic Collector and Log Analytics	https://learn.microsoft.com/en-us/azure/expressroute/how-to-configure-traffic-collector
Configure Azure ExpressRoute Direct resources	https://learn.microsoft.com/en-us/azure/expressroute/how-to-expressroute-direct-portal
Configure route filters for ExpressRoute Microsoft peering	https://learn.microsoft.com/en-us/azure/expressroute/how-to-routefilter-portal
Configure ExpressRoute peering using Azure CLI	https://learn.microsoft.com/en-us/azure/expressroute/howto-routing-cli
Use Azure Monitor metrics and logs for ExpressRoute	https://learn.microsoft.com/en-us/azure/expressroute/monitor-expressroute-reference
Configure rate limiting on ExpressRoute Direct circuits	https://learn.microsoft.com/en-us/azure/expressroute/rate-limit

Integrations & Coding Patterns

Topic	URL
Apply Cisco and Juniper NAT configurations for ExpressRoute	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-config-samples-nat
Programmatically manage ExpressRoute circuits using Azure CLI	https://learn.microsoft.com/en-us/azure/expressroute/howto-circuit-cli
Create and manage ExpressRoute circuits using Azure CLI	https://learn.microsoft.com/en-us/azure/expressroute/howto-circuit-cli
Configure S2S VPN over ExpressRoute Microsoft peering	https://learn.microsoft.com/en-us/azure/expressroute/site-to-site-vpn-over-microsoft-peering

Deployment

Topic	URL
Migrate production traffic between ExpressRoute circuits	https://learn.microsoft.com/en-us/azure/expressroute/circuit-migration
Understand ExpressRoute Direct SKUs and technical requirements	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-erdirect-about
Deploy an Azure ExpressRoute circuit via ARM template	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-howto-circuit-resource-manager-template
Migrate to zone-redundant ExpressRoute gateway SKUs	https://learn.microsoft.com/en-us/azure/expressroute/expressroute-howto-gateway-migration-portal
Provision ExpressRoute circuit and gateway using Terraform	https://learn.microsoft.com/en-us/azure/expressroute/quickstart-create-expressroute-vnet-terraform

Comments

Markdown supported

Details

Author: microsoftdocs
Repository: microsoftdocs/agent-skills
Category: Cloud & DevOps
Installs: 176
GitHub stars: 796

Report

More skills

All skills

lark-apps

open.feishu.cn

732.0k

Develop and host Miaoda (Spark/Miaoda) apps: app creation, local full-stack development, cloud generation and iteration, creative design (UI mockups / interactive prototypes / wireframes / landing pages / dashboards / slide decks / visual exploration), integration of AI-related capabilities, Feishu platform capabilities, or other external capabilities; log/Trace/monitoring metric/PV/UV queries; environment variable management; app collaborators and collaboration permissions; app roles and members; and automation triggers (scheduled / record changes / Webhook / Feishu approvals). Use when users want to develop or create a system, tool, platform, or app; develop locally or in the cloud, modify, deploy, publish, launch, or get a shareable link; create a page or website with HTML and deploy it to Miaoda; design, create a mockup, prototype, wireframe, PPT, deck, or visual exploration; or mention Miaoda/Spark/Miaoda apps (links like `/app/app_xxx` or `/page/<token>`, runtime domains like *.aiforce.cloud), app databases, app file storage, open API Keys, visibility, app collaborators/developer permissions, app roles/role members, production logs, API request volume, error volume, latency, traffic, environment variables, or setting up automation tasks, scheduled triggers, or approval-triggered automation for Miaoda apps. Not for regular cloud drive file uploads (lark-drive), Feishu document editing (lark-doc), or native slide creation (lark-slides).

azure-prepare

github.com/microsoft

571.7k

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Terraform), and Dockerfiles for the Azure Developer CLI (azd) workflow. USE ONLY when the user explicitly wants to use azd as the deployment tool, or the project already has an azure.yaml file. DO NOT USE FOR: non-azd deployments, Python App Service code-only deploys (use python-appservice-deploy), or cross-cloud migration (use azure-cloud-migrate). WHEN: prepare app for azd, create azure.yaml, set up azd infrastructure, modernize app for Azure with azd, deploy with azd, function app, timer trigger, service bus trigger, event-driven function, managed identity, generate Bicep, generate Terraform, create and deploy to Azure.

wizard

github.com/mattpocock

571.5k

Generate an interactive bash wizard that walks a human through steps only they can perform. Use when provisioning infrastructure, setting up credentials or CI secrets, walking an unfamiliar third-party dashboard, or running a one-off migration or cutover. Don't invoke this for steps the agent can perform itself.

azure-ai

github.com/microsoft

571.2k

Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.