SkillRepo
Sign InSign Up
Catalog
MicrosoftDocs/azure-immersive-reader

MicrosoftDocs

azure-immersive-reader

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).

v1.0Latest
New~1.3kUpdated Jun 26, 2026

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

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
Files1
1 files · 18.2 KB

Select a file to preview

Overall Score

78/100

Grade

B

Good

Safety

82

Quality

75

Clarity

80

Completeness

72

Summary

This skill provides expert guidance for Azure AI Immersive Reader development, covering best practices, security configuration, feature limits, and integration patterns. It functions as a knowledge index that directs agents to fetch Microsoft Learn documentation via network tools (mcp_microsoftdocs or fetch_webpage) and references local content sections by line range.

Detected Capabilities

network requestfetch remote documentationread file (local reference)knowledge lookupindex navigation

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

immersive reader setupentra id authenticationread-aloud configurationtranslation settingsuser preferences storagejavascript sdk integrationvision read iostoken cachinglanguage support

Risk Signals

INFO

Network access to github.com and learn.microsoft.com

metadata, compatibility section
INFO

Conditional dependency on mcp_microsoftdocs or fetch_webpage tools

How to Use This Skill section
INFO

Metadata staleness check (3-month threshold) suggests documentation may become outdated

How to Use This Skill section

Referenced Domains

External domains referenced in skill content, detected by static analysis.

github.comlearn.microsoft.com

Use Cases

  • Optimize read-aloud performance by caching authentication tokens
  • Configure Entra ID authentication and role-based access control for Immersive Reader
  • Implement multi-language translation and read-aloud in web applications
  • Integrate Immersive Reader JS SDK with custom launch buttons and HTML content
  • Set up iOS app with Vision Read and Immersive Reader capabilities
  • Store and retrieve per-user reading preferences and language settings
  • Troubleshoot language support limitations and feature availability

Quality Notes

  • Well-structured category index with clear line ranges and descriptions aids agent navigation
  • Explicit fallback mechanism (mcp_microsoftdocs → fetch_webpage) improves reliability
  • Metadata staleness guidance helps users maintain documentation freshness
  • Line-based navigation enables efficient targeting of specific content without full file reads
  • IMPORTANT note emphasizes query string parameters for remote fetches, reducing misconfiguration
  • URL references are complete and directly actionable (11 distinct learn.microsoft.com articles)
  • License file included but unrelated to skill content — does not enhance or detract from functionality
Model: claude-haiku-4-5-20251001Analyzed: Jun 26, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Use MicrosoftDocs/azure-immersive-reader in your dev environment

Start a Developer trial

Command Palette

Search for a command to run...