Skip to main content
skill CX Codex

azure-immersive-reader — Claude Code skill: what it does

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.

CC-BY-4.0 161 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-immersive-reader -a claude-code
Open on GitHub

What azure-immersive-reader does

The skill gives the agent a structured knowledge base for Azure AI Immersive Reader development: authentication with Microsoft Entra, token caching patterns, read-aloud and translation configuration, per-user preference storage, HTML and MathML preparation, launch button customization, and multi-resource setups in a single app.

The agent navigates a category index to find the right section, then fetches current documentation from learn.microsoft.com via mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage. Network access is required for that remote fetch; without it only the local quick-reference content is available.

The skill explicitly does not cover Azure AI Language, Azure AI Speech, or Azure Translator — those have their own dedicated skills (azure-language-service, azure-speech, azure-translator). Sending those questions here will get you the wrong answers.

What it helps with

  • Cache Entra authentication tokens to cut auth overhead in Immersive Reader
  • Integrate the JS SDK and launch Immersive Reader from web app code
  • Prepare HTML and MathML content for correct rendering in the reader
  • Check which languages support read-aloud and translation features
  • Store and retrieve per-user reading and language preferences

Example prompts for the agent

  • Set up Entra token caching for Azure Immersive Reader in my app
  • Add a custom launch button and wire up the JS SDK on this page
  • Show me how to handle multiple Immersive Reader resources in one application

How to install azure-immersive-reader

1Skills CLI (Vercel)

npx skills add MicrosoftDocs/Agent-Skills --skill azure-immersive-reader -a claude-code

2Manually: put the files in place

~/.claude/skills/azure-immersive-reader/SKILL.md

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

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

Questions about azure-immersive-reader

How do I install azure-immersive-reader in Claude Code?

Run npx skills add MicrosoftDocs/Agent-Skills --skill azure-immersive-reader -a claude-code. The skill file will be available at ~/.claude/skills/azure-immersive-reader/SKILL.md.

What does the azure-immersive-reader skill do?

It adds expert knowledge about Azure AI Immersive Reader to the agent: JS SDK integration patterns, Entra auth configuration, read-aloud and translation settings, HTML and MathML prep, language support limits, and user preference storage.

Does this skill work for Azure Speech or Azure Translator tasks?

No. This skill covers Azure AI Immersive Reader only. For Azure AI Speech use azure-speech, for Azure Translator use azure-translator, and for Azure AI Language use azure-language-service.

Source text

SKILL.md · CC-BY-4.0
---
name: azure-immersive-reader
description: Expert knowledge for Azure AI Immersive Reader development including best practices, limits & quotas, security, configuration, and integrations & coding patterns. Use when tuning read-aloud/translation, storing user prefs, Entra auth setup, JS SDK integration, or language support, and other Azure AI Immersive Reader related development tasks. Not for Azure AI Language (use azure-language-service), Azure AI Speech (use azure-speech), Azure Translator (use azure-translator), Azure AI services (use microsoft-foundry-tools).
compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata:
  generated_at: "2026-03-16"
  generator: "docs2skills/1.0.0"
---
# Azure AI Immersive Reader Skill

This skill provides expert guidance for Azure AI Immersive Reader. Covers best practices, 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`), 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 |
|----------|-------|-------------|
| Best Practices | L33-L37 | Guidance on improving Immersive Reader performance by caching authentication tokens, including token reuse patterns and reducing auth overhead. |
| Limits & Quotas | L38-L42 | Supported languages and feature availability for Immersive Reader (e.g., which languages work with read-aloud, translation, and other capabilities). |
| Security | L43-L49 | Configuring Immersive Reader security: creating the resource with Entra auth, managing Entra role assignments, and setting cookie policy and user consent. |
| Configuration | L50-L56 | Configuring Immersive Reader behavior: read-aloud voice/speed, translation languages and behavior, and storing/managing per-user reading and language preferences. |
| Integrations & Coding Patterns | L57-L66 | Implementing Immersive Reader in web/iOS apps: launch flows, JS SDK usage, HTML/MathML prep, custom buttons, multi-resource setups, and Vision Read integration. |

### Best Practices
| Topic | URL |
|-------|-----|
| Cache Immersive Reader auth tokens for performance | https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-cache-token |

### Limits & Quotas
| Topic | URL |
|-------|-----|
| Check supported languages for Immersive Reader features | https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/language-support |

### Security
| Topic | URL |
|-------|-----|
| Create Immersive Reader resource and configure Entra auth | https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-create-immersive-reader |
| Configure Immersive Reader cookie policy and consent | https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to/set-cookie-policy |
| Update Immersive Reader Entra role assignments for security | https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/security-how-to-update-role-assignment |

### Configuration
| Topic | URL |
|-------|-----|
| Configure Immersive Reader Read Aloud options | https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-configure-read-aloud |
| Configure translation settings in Immersive Reader | https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-configure-translation |
| Store and manage Immersive Reader user preferences | https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-store-user-preferences |

### Integrations & Coding Patterns
| Topic | URL |
|-------|-----|
| Customize the Immersive Reader launch button | https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-customize-launch-button |
| Launch Azure Immersive Reader from application code | https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-launch-immersive-reader |
| Use multiple Immersive Reader resources in one app | https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-multiple-resources |
| Prepare HTML content for Immersive Reader integration | https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-prepare-html |
| Render MathML expressions in Immersive Reader | https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to/display-math |
| Use the Immersive Reader JavaScript SDK API | https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/reference |
| Build iOS app integrating Vision Read and Immersive Reader | https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/tutorial-ios-picture-immersive-reader |

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

Similar skills

All skills for Cloud: AWS, Azure, GCP →

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-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-fluid-relay 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. CX Codex +1 160installs 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