SkillsAdd

microsoftdocs/agent-skills

azure-relay

Expert knowledge for Azure Relay development including troubleshooting, security, configuration, and integrations & coding patterns.

First seen Mar 10, 2026

Installation

$ npx skills add microsoftdocs/agent-skills --skill azure-relay
View on skills.sh ↗ GitHub repository ↗

Summary

  • Expert knowledge for Azure Relay development including troubleshooting, security, configuration, and integrations & coding patterns.
  • Use when configuring Hybrid Connections, WCF relays, Entra ID/SAS auth, Private Link, or .NET/Node.js Relay clients, and other Azure Relay related development tasks.
  • Not for Azure Service Bus (use azure-service-bus), Azure Event Hubs (use azure-event-hubs), Azure Web PubSub (use azure-web-pubsub), Azure Application Gateway (use azure-application-gateway).

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

microsoft-foundry Shared topics
microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and …

576.5K installs
azure-prepare Shared topics
microsoft/azure-skills

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Te…

568.3K installs
azure-aigateway Shared topics
microsoft/azure-skills

Configure Azure API Management as an AI Gateway for AI models, MCP tools, and agents. WHEN: sem…

566.3K installs
azure-compute Shared topics
microsoft/azure-skills

Azure VM/VMSS router. WHEN: create / provision / deploy / spin-up VM, recommend VM size, compar…

510K installs
azure-hosted-copilot-sdk Shared topics
microsoft/azure-skills 440.4K installs
azure-quotas Shared topics
microsoft/azure-skills

Check/manage Azure quotas and usage across providers. For deployment planning, capacity validat…

436.1K installs

Also in this package

Other skills from microsoftdocs/agent-skills · top by installs.

npx skills add microsoftdocs/agent-skills
azure-container-apps 13 azure-sql-database 12 azure-well-architected 399 azure-architecture 325 azure-pipelines 315 azure-functions 289 azure-devops 270 azure-security 251 azure-monitor 251 azure-blob-storage 242

Browse all from microsoftdocs/agent-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 737
License LICENSE
Default branch main
Open issues 2
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

CompatibilityRequires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
More metadata
generated_at
2026-05-17
generator
docs2skills/1.0.0

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 4,469 B
  • docs SUMMARY.md 509 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 118 installs

SKILL.md

Azure Relay Skill

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

IMPORTANT for Agent: If metadata.generatedat is more than 3 months old, suggest the user pull the latest version from the repository. If mcpmicrosoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

  • Preferred: Use mcpmicrosoftdocs:microsoftdocs_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 L32-L36 Diagnosing and fixing common Azure Relay exceptions, including connection, authentication, quota, and configuration errors, with guidance on causes and resolutions.
Security L37-L46 Authentication and network security for Azure Relay: Entra ID and SAS auth, managed identities, IP firewall, virtual network rules, and Private Link Service configuration.
Configuration L47-L51 Network and firewall requirements for Azure Relay, including which ports/protocols to open for Hybrid Connections and WCF relays and how to configure them.
Integrations & Coding Patterns L52-L57 Using Azure Relay Hybrid Connections from .NET and Node.js (WebSockets), plus low-level protocol details for implementing custom clients and integrations

Troubleshooting

Topic URL
Resolve common Azure Relay exceptions https://learn.microsoft.com/en-us/azure/azure-relay/relay-exceptions

Security

Topic URL
Authenticate applications to Azure Relay with Entra ID https://learn.microsoft.com/en-us/azure/azure-relay/authenticate-application
Use managed identities to access Azure Relay https://learn.microsoft.com/en-us/azure/azure-relay/authenticate-managed-identity
Configure IP firewall rules for Azure Relay https://learn.microsoft.com/en-us/azure/azure-relay/ip-firewall-virtual-networks
Configure network security for Azure Relay https://learn.microsoft.com/en-us/azure/azure-relay/network-security
Secure Azure Relay with Private Link Service https://learn.microsoft.com/en-us/azure/azure-relay/private-link-service
Configure SAS and Entra ID auth for Azure Relay https://learn.microsoft.com/en-us/azure/azure-relay/relay-authentication-and-authorization

Configuration

Topic URL
Configure required port settings for Azure Relay https://learn.microsoft.com/en-us/azure/azure-relay/relay-port-settings

Integrations & Coding Patterns

Topic URL
Use Azure Relay Hybrid Connections .NET APIs https://learn.microsoft.com/en-us/azure/azure-relay/relay-hybrid-connections-dotnet-api-overview
Use Azure Relay Node.js WebSocket APIs https://learn.microsoft.com/en-us/azure/azure-relay/relay-hybrid-connections-node-ws-api-overview
Implement Azure Relay Hybrid Connections protocol https://learn.microsoft.com/en-us/azure/azure-relay/relay-hybrid-connections-protocol