Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
microsoftdocs avatar

Azure Immersive Reader

  • 94 installs
  • 682 repo stars
  • Updated August 3, 2026
  • microsoftdocs/agent-skills

Helps with ai & agent building tasks during AI-assisted development.

About

azure-immersive-reader is a Claude Code skill for ai & agent building. It helps solo builders move faster with AI-assisted coding.

  • azure-immersive-reader
  • AI & Agent Building
  • AI-coding skill

Azure Immersive Reader by the numbers

  • 94 all-time installs (skills.sh)
  • +10 installs in the week ending Aug 4, 2026 (Skillselion tracking)
  • Ranked #4,614 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-immersive-reader

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs94
repo stars682
Last updatedAugust 3, 2026
Repositorymicrosoftdocs/agent-skills

What it does

Helps with ai & agent building tasks during AI-assisted development.

Files

SKILL.mdMarkdownGitHub ↗

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

CategoryLinesDescription
Best PracticesL33-L37Guidance on improving Immersive Reader performance by caching authentication tokens, including token reuse patterns and reducing auth overhead.
Limits & QuotasL38-L42Supported languages and feature availability for Immersive Reader (e.g., which languages work with read-aloud, translation, and other capabilities).
SecurityL43-L49Configuring Immersive Reader security: creating the resource with Entra auth, managing Entra role assignments, and setting cookie policy and user consent.
ConfigurationL50-L56Configuring Immersive Reader behavior: read-aloud voice/speed, translation languages and behavior, and storing/managing per-user reading and language preferences.
Integrations & Coding PatternsL57-L66Implementing 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

TopicURL
Cache Immersive Reader auth tokens for performancehttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-cache-token

Limits & Quotas

TopicURL
Check supported languages for Immersive Reader featureshttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/language-support

Security

TopicURL
Create Immersive Reader resource and configure Entra authhttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-create-immersive-reader
Configure Immersive Reader cookie policy and consenthttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to/set-cookie-policy
Update Immersive Reader Entra role assignments for securityhttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/security-how-to-update-role-assignment

Configuration

TopicURL
Configure Immersive Reader Read Aloud optionshttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-configure-read-aloud
Configure translation settings in Immersive Readerhttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-configure-translation
Store and manage Immersive Reader user preferenceshttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-store-user-preferences

Integrations & Coding Patterns

TopicURL
Customize the Immersive Reader launch buttonhttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-customize-launch-button
Launch Azure Immersive Reader from application codehttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-launch-immersive-reader
Use multiple Immersive Reader resources in one apphttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-multiple-resources
Prepare HTML content for Immersive Reader integrationhttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-prepare-html
Render MathML expressions in Immersive Readerhttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to/display-math
Use the Immersive Reader JavaScript SDK APIhttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/reference
Build iOS app integrating Vision Read and Immersive Readerhttps://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/tutorial-ios-picture-immersive-reader

Related skills

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.