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
NewUpdated 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.
Grades are signals, not a certification. Always review a skill yourself before use.
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.
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 — a Developer account adds skills to your library and syncs them via the SkillRepo CLI.