jpskill.com
🛠️ 開発・MCP コミュニティ

azure-immersive-reader

Azure AI Immersive Readerの開発において、ベストプラクティス、制限、セキュリティ、設定、統合に関する専門知識を提供するSkill。

📜 元の英語説明(参考)

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

🇯🇵 日本人クリエイター向け解説

一言でいうと

Azure AI Immersive Readerの開発において、ベストプラクティス、制限、セキュリティ、設定、統合に関する専門知識を提供するSkill。

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⬇ このSkillをダウンロード(.skill) 元のソースを見る ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-17
取得日時
2026-05-17
同梱ファイル
1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

Azure AI Immersive Reader スキル

このスキルは、Azure AI Immersive Reader に関する専門的なガイダンスを提供します。ベストプラクティス、制限とクォータ、セキュリティ、構成、および統合とコーディングパターンを網羅しています。ローカルのクイックリファレンスコンテンツとリモートドキュメント取得機能を組み合わせています。

このスキルの使い方

Agent への重要事項: 以下のカテゴリインデックスを使用して、関連するセクションを見つけてください。行範囲が指定されているカテゴリ（例: L35-L120）の場合は、指定された行で read_file を使用してください。ファイルリンクが指定されているカテゴリ（例: [security.md](security.md)）の場合は、リンクされた参照ファイルで read_file を使用してください。

Agent への重要事項: metadata.generated_at が3か月以上前の場合、ユーザーにリポジトリから最新バージョンをプルするように提案してください。mcp_microsoftdocs ツールが利用できない場合、ユーザーにインストールを提案してください: インストールガイド

このスキルは、ドキュメントコンテンツを取得するためにネットワークアクセスを必要とします。

  • 推奨: クエリ文字列 from=learn-agent-skill を指定して mcp_microsoftdocs:microsoft_docs_fetch を使用してください。Markdown を返します。
  • フォールバック: クエリ文字列 from=learn-agent-skill&accept=text/markdown を指定して fetch_webpage を使用してください。Markdown を返します。

カテゴリインデックス

カテゴリ 行 説明
ベストプラクティス L33-L37 認証トークンのキャッシュによる Immersive Reader のパフォーマンス向上に関するガイダンス。トークン再利用パターンと認証オーバーヘッドの削減を含みます。
制限とクォータ L38-L42 Immersive Reader のサポート言語と機能の利用可能性（例: 音声読み上げ、翻訳、その他の機能がどの言語で動作するか）。
セキュリティ L43-L49 Immersive Reader のセキュリティ構成: Entra 認証でのリソース作成、Entra ロール割り当ての管理、Cookie ポリシーとユーザー同意の設定。
構成 L50-L56 Immersive Reader の動作構成: 音声読み上げの音声/速度、翻訳言語と動作、ユーザーごとの読み上げと言語設定の保存/管理。
統合とコーディングパターン L57-L66 Web/iOS アプリでの Immersive Reader の実装: 起動フロー、JS SDK の使用、HTML/MathML の準備、カスタムボタン、複数リソース設定、Vision Read 統合。

ベストプラクティス

トピック URL
パフォーマンス向上のための Immersive Reader 認証トークンのキャッシュ https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-cache-token

制限とクォータ

トピック URL
Immersive Reader 機能のサポート言語を確認する https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/language-support

セキュリティ

トピック URL
Immersive Reader リソースを作成し、Entra 認証を構成する https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-create-immersive-reader
Immersive Reader の Cookie ポリシーと同意を構成する https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to/set-cookie-policy
セキュリティのために Immersive Reader の Entra ロール割り当てを更新する https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/security-how-to-update-role-assignment

構成

トピック URL
Immersive Reader の音声読み上げオプションを構成する https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-configure-read-aloud
Immersive Reader の翻訳設定を構成する https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-configure-translation
Immersive Reader のユーザー設定を保存および管理する https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-store-user-preferences

統合とコーディングパターン

トピック URL
Immersive Reader の起動ボタンをカスタマイズする https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-customize-launch-button
アプリケーションコードから Azure Immersive Reader を起動する https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-launch-immersive-reader
1つのアプリで複数の Immersive Reader リソースを使用する https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-multiple-resources
Immersive Reader 統合のために HTML コンテンツを準備する https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-prepare-html
Immersive Reader で MathML 式をレンダリングする https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to/display-math
Immersive Reader JavaScript SDK API を使用する https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/reference
Vision Read と Immersive Reader を統合する iOS アプリを構築する https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/tutorial-ios-picture-immersive-reader
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

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