Skip to main content
skill CX Codex

azure-fluid-relay — skill for Claude Code: real-time collaboration

Adds Azure Fluid Relay guidance to Claude Code: a service for syncing state across clients in real time. Use it when building collaborative apps with JWT auth, deploying to Static Web Apps, or managing Fluid Relay containers.

CC-BY-4.0 160 installs ★ 818 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add MicrosoftDocs/Agent-Skills --skill azure-fluid-relay -a claude-code
Open on GitHub

What azure-fluid-relay does

Covers the full development cycle with Azure Fluid Relay: authentication via JWT tokens, configuring AzureClient to connect, audience APIs for presence tracking. Includes container recovery after failure, service limits, key rotation, and deployment to Azure Static Web Apps.

Fetches remote docs from Microsoft Learn via mcp_microsoftdocs or fetch_webpage, so requires network access. Local reference content is current as of February 2026; if older than three months, prompts to pull the latest version from the repository.

Helps you work with Fluid Framework while checking version compatibility, set up local mode for testing, validate container ownership, and integrate Fluid with React via presence APIs.

What it helps with

  • connect an app to Azure Fluid Relay using AzureClient
  • build a secure token provider on Azure Functions
  • set up JWT authentication for Fluid Relay users
  • restore a corrupted Fluid Relay container
  • deploy a collaborative app to Static Web Apps

Example prompts for the agent

  • How do I implement a token provider on Azure Functions for Fluid Relay with JWT?
  • Show me how to connect a React app to Azure Fluid Relay using the audience API
  • How can I recover a Fluid Relay container after a failure?

How to install azure-fluid-relay

1Skills CLI (Vercel)

npx skills add MicrosoftDocs/Agent-Skills --skill azure-fluid-relay -a claude-code

2Manually: put the files in place

~/.claude/skills/azure-fluid-relay/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/azure-fluid-relay/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about azure-fluid-relay

How do I install azure-fluid-relay in Claude Code?

Run npx skills add MicrosoftDocs/Agent-Skills --skill azure-fluid-relay -a claude-code in your terminal. The skill will then be available at ~/.claude/skills/azure-fluid-relay/SKILL.md.

What does the azure-fluid-relay skill do?

Provides Claude Code with complete reference material for Azure Fluid Relay development: auth, framework integration, deployment, security, data recovery, and service quotas.

Do I need this skill if I'm using Azure SignalR Service?

No. This skill is specific to Azure Fluid Relay. Use the separate azure-signalr-service skill for SignalR.

Source text

SKILL.md · CC-BY-4.0
---
name: azure-fluid-relay
description: Expert knowledge for Azure Fluid Relay development including troubleshooting, best practices, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using AzureClient, audience APIs, JWT auth tokens, container recovery, or Static Web Apps hosting, and other Azure Fluid Relay related development tasks. Not for Azure Web PubSub (use azure-web-pubsub), Azure SignalR Service (use azure-signalr-service), Azure Relay (use azure-relay), Azure Service Bus (use azure-service-bus).
compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata:
  generated_at: "2026-02-28"
  generator: "docs2skills/1.0.0"
---
# Azure Fluid Relay Skill

This skill provides expert guidance for Azure Fluid Relay. Covers troubleshooting, best practices, 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](https://github.com/MicrosoftDocs/mcp/blob/main/README.md)

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 | L35-L39 | Recovering from corrupted Azure Fluid Relay container data, including detection, mitigation steps, and restoring or reconstructing data to resume collaboration. |
| Best Practices | L40-L44 | Guidance on integrating Azure Fluid Relay with test automation frameworks, setting up automated tests, and validating Fluid collaboration scenarios in CI/CD workflows. |
| Limits & Quotas | L45-L49 | Details on Azure Fluid Relay capacity limits, throttling behavior, quotas per tenant/container, and guidance to avoid or handle rate limiting and overuse scenarios. |
| Security | L50-L60 | Securing Fluid Relay apps: auth/JWT design, token providers, key rotation, CMK and data encryption, and validating container creator identity. |
| Configuration | L61-L66 | Configuring compatible Fluid Framework client/server versions with Azure Fluid Relay and deleting Fluid Relay containers via Azure CLI. |
| Integrations & Coding Patterns | L67-L73 | Building Fluid apps with AzureClient: connecting to Azure Fluid Relay, configuring local dev/test mode, and using audience APIs with React for presence and user management |
| Deployment | L74-L77 | Guidance for deploying Fluid Framework apps with Azure Fluid Relay to Azure Static Web Apps, including setup, configuration, and integration steps for hosting collaborative apps. |

### Troubleshooting
| Topic | URL |
|-------|-----|
| Recover corrupted Azure Fluid Relay container data | https://learn.microsoft.com/en-us/azure/azure-fluid-relay/how-tos/container-recovery |

### Best Practices
| Topic | URL |
|-------|-----|
| Use test automation frameworks with Azure Fluid Relay | https://learn.microsoft.com/en-us/azure/azure-fluid-relay/how-tos/test-automation |

### Limits & Quotas
| Topic | URL |
|-------|-----|
| Review Azure Fluid Relay service limits and throttling | https://learn.microsoft.com/en-us/azure/azure-fluid-relay/reference/service-limits |

### Security
| Topic | URL |
|-------|-----|
| Implement authentication and authorization for Fluid Relay apps | https://learn.microsoft.com/en-us/azure/azure-fluid-relay/concepts/authentication-authorization |
| Use customer-managed keys with Azure Fluid Relay | https://learn.microsoft.com/en-us/azure/azure-fluid-relay/concepts/customer-managed-keys |
| Configure data encryption for Azure Fluid Relay | https://learn.microsoft.com/en-us/azure/azure-fluid-relay/concepts/data-encryption |
| Implement a secure TokenProvider with Azure Functions for Fluid Relay | https://learn.microsoft.com/en-us/azure/azure-fluid-relay/how-tos/azure-function-token-provider |
| Understand and configure Azure Fluid Relay JWT token contract | https://learn.microsoft.com/en-us/azure/azure-fluid-relay/how-tos/fluid-json-web-token |
| Rotate Azure Fluid Relay tenant access keys securely | https://learn.microsoft.com/en-us/azure/azure-fluid-relay/how-tos/rotate-fluid-relay-access-keys |
| Validate container creator identity in Azure Fluid Relay | https://learn.microsoft.com/en-us/azure/azure-fluid-relay/how-tos/validate-document-creator |

### Configuration
| Topic | URL |
|-------|-----|
| Configure Fluid Framework versions compatible with Azure Fluid Relay | https://learn.microsoft.com/en-us/azure/azure-fluid-relay/concepts/version-compatibility |
| Delete Azure Fluid Relay containers using Azure CLI | https://learn.microsoft.com/en-us/azure/azure-fluid-relay/how-tos/container-deletion |

### Integrations & Coding Patterns
| Topic | URL |
|-------|-----|
| Connect applications to Azure Fluid Relay using AzureClient | https://learn.microsoft.com/en-us/azure/azure-fluid-relay/how-tos/connect-fluid-azure-service |
| Configure AzureClient local mode for Fluid app testing | https://learn.microsoft.com/en-us/azure/azure-fluid-relay/how-tos/local-mode-with-azure-client |
| Use Fluid Framework audience features with React and AzureClient | https://learn.microsoft.com/en-us/azure/azure-fluid-relay/how-tos/use-audience-in-fluid |

### Deployment
| Topic | URL |
|-------|-----|
| Deploy Fluid applications to Azure Static Web Apps | https://learn.microsoft.com/en-us/azure/azure-fluid-relay/how-tos/deploy-fluid-static-web-apps |

© MicrosoftDocs · CC-BY-4.0 · MicrosoftDocs/Agent-Skills

Similar skills

All skills for Backend and APIs →
analyzing-azure-activity-logs-for-threats mahipal analyzing-azure-activity-logs-for-threats — a skill for Claude Code and five other platforms that builds KQL queries against Azure Monitor to surface suspicious operations, privilege escalation, and sign-in anomalies in an Azure tenant. CX Codex +1 479installs azure-keyvault devops-skills A skill for Azure Key Vault: stores secrets, keys and certificates, sets up access and wires them into Azure services. CX Codex +1 366installs azure-monitor-audit devops-skills azure-monitor-audit configures Azure Monitor, Log Analytics, and Activity Logs for centralized auditing. It helps fulfill logging requirements for SOC 2, HIPAA, PCI DSS, or ISO 27001. CX Codex +1 349installs auditing-azure-active-directory-configuration mahipal auditing-azure-active-directory-configuration audits Microsoft Entra ID security using Microsoft Graph API, Az CLI, and ScoutSuite. It finds over-privileged roles, Conditional Access gaps, and stale accounts. CX Codex +1 241installs azure-cosmosdb alinaqi Skill for Azure Cosmos DB work: partition key selection, consistency levels, change feed, and SDK patterns with TypeScript examples. Adds CRUD templates, hierarchical keys, and cross-partition query patterns to your IDE. CX Codex +1 269installs azure-infra-engineer VoltAgent Community azure-infra-engineer is a Claude Code subagent for Azure networking, Entra ID, PowerShell, and Bicep. It supports deployment planning, access reviews, and operations automation. CX Codex 245installs

From the same set144

The whole set →
azure-relay This skill guides Azure Relay setup, error diagnosis, and Hybrid Connections work. It fits projects using .NET or Node.js relay clients. CX Codex +1 162installs azure-dedicated-hsm Hands the agent a working map of Azure Dedicated HSM: cluster sizing, networking, secure configuration and migration, with links into Microsoft Learn. CX Codex +1 162installs azure-osconfig This skill guides Azure OSConfig development, from diagnosing agent and Azure IoT Hub issues to configuring Windows security and Linux devices. CX Codex +1 161installs azure-open-datasets A reference skill for Azure Open Datasets limits: throttling on non-Spark downloads, quota ceilings and retry handling, pulled from Microsoft Learn docs. CX Codex +1 161installs azure-immersive-reader A skill for Claude Code, Codex, Cursor, GitHub Copilot, and Gemini CLI that brings Azure AI Immersive Reader expertise to the agent. Covers JS SDK integration, Entra auth setup, read-aloud configuration, and language support. CX Codex +1 161installs azure-import-export This skill guides work on Azure Import/Export jobs, from diagnosing failures to checking service limits and configuring encryption keys. Use it while building or troubleshooting these jobs. CX Codex +1 161installs azure-payment-hsm azure-payment-hsm is a Claude Code skill for configuring Azure Payment HSM and diagnosing deployment issues. It activates for work on VNets, FastPath, payShield Manager, traffic routing, or HA/DR design. CX Codex +1 161installs azure-external-attack-surface-management Skill with expert knowledge for Azure External Attack Surface Management: inventory filters by ASN, domains, hosts, IPs, pages, SSL certs, and data export to analytics. CX Codex +1 152installs

Project sponsors

Companies that keep this analytics open