About azure-health-bot
azure-health-bot is an agent skill for people configuring and integrating Azure Health Bot. It combines local reference material with remotely fetched documentation on security, conversation behavior, channels, and APIs.
Key features
- 01Healthcare conversation error handling
- 02Authentication and privacy guidance
- 03Bot scenarios and conversation settings
- 04Human and Teams handoff
- 05Channel and web chat integrations
- 06API and telemetry integrations
Use cases
- 01Designing recovery paths for bot errors
- 02Managing user consent and data access
- 03Setting up human handoff
- 04Connecting a bot to messaging channels
MCP support
The skill can fetch Microsoft documentation through the mcp_microsoftdocs microsoft_docs_fetch tool; it also describes fetch_webpage as a fallback.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-health-botAfter installing, type/azure-health-botin Claude Code to confirm it loaded.
Details
From the project READMEAzure Health Bot Skill
This skill provides expert guidance for Azure Health Bot. Covers best practices, 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), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: If
metadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools 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_fetchwith query stringfrom=learn-agent-skill. Returns Markdown. - Fallback: Use
fetch_webpagewith query stringfrom=learn-agent-skill&accept=text/markdown. Returns Markdown.
Category Index
| Category | Lines | Description |
|---|---|---|
| Best Practices | L32-L36 | Guidance on designing robust error-handling flows in Azure Health Bot scenarios, including detecting failures, user-friendly recovery paths, and safe handling of clinical conversation errors. |
| Security | L37-L50 | Security, compliance, and privacy for Health Bot: auth providers, end-user auth/consent, data access/deletion, encryption keys, secrets/keys, abuse monitoring, safeguards, and portal permissions |
| Configuration | L51-L68 | Configuring bot behavior and conversations: welcome/help messages, feedback, interruptions, human/Teams handoff, terms links, and managing scenarios, variables, cards, and versions. |
| Integrations & Coding Patterns | L69-L89 | Integrating Azure Health Bot/Agent with channels (Teams, SMS, WhatsApp, Facebook), embedding web chat, calling/triggering scenarios via APIs/JS, telemetry with App Insights, and enabling voice and clinical safeguards. |
Best Practices
| Topic | URL |
|---|---|
| Design error handling flows in healthcare bot scenarios | https://learn.microsoft.com/en-us/azure/health-bot/errorhandling |