azure-bot-service
Expert knowledge for Azure AI Bot Service development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building bots with adaptive dialogs, Direct Line/Web Chat, Teams integration, OAuth/SSO, or proactive messages, and other Azure AI Bot Service related development tasks. Not for Azure Health Bot (use azure-health-bot), Azure Web PubSub (use azure-web-pubsub), Azure Functions (use azure-functions), Azure App Service (use azure-app-service).
npx skills add MicrosoftDocs/Agent-Skills --skill azure-bot-service --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
What it does
The skill provides expert guidance for Azure AI Bot Service, including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.
How it works
- Use the Category Index to locate relevant sections. For categories with line ranges, use read_file with the specified lines. For categories with file links, use read_file on the linked reference file.
- If metadata.generated_at is more than 3 months old, suggest pulling the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest installing it via the Installation Guide link.
- Requires network access to fetch documentation content via mcp_microsoftdocs:microsoft_docs_fetch (preferred) or fetch_webpage (fallback).
When to use it
Use when building Azure AI Bot Service tasks such as adaptive dialogs, Direct Line/Web Chat, Teams integration, OAuth/SSO, proactive messages, and other related development tasks.
What it can touch
- Tools: claude-code, copilot, codex (declared)
- Access to documentation content via mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage
Caveats
- License: CC-BY-4.0
- Requires network access and the ability to fetch remote documentation
- Not applicable to Azure Health Bot, Azure Web PubSub, Azure Functions, or Azure App Service per scope notes
# Azure AI Bot Service Skill This skill provides expert guidance for Azure AI Bot Service. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. 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](https://github.com/MicrosoftDocs/mcp/blob/main/README.md) 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 `fe
- How to Use This Skill
- Category Index
- Troubleshooting
- Best Practices
- Decision Making
- Architecture & Design Patterns
- Limits & Quotas
- Security
- Configuration
- Integrations & Coding Patterns
- Deployment
What does the azure-bot-service skill do?
Expert knowledge for Azure AI Bot Service development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building bots with adaptive dialogs, Direct Line/Web Chat, Teams integration, OAuth/SSO, or proactive messages, and other Azure AI Bot Service related development tasks. Not for Azure Health Bot (use azure-health-bot), Azure Web PubSub (use azure-web-pubsub), Azure Functions (use azure-functions), Azure App Service (use azure-app-service).
How do I install it?
Run `npx skills add MicrosoftDocs/Agent-Skills --skill azure-bot-service --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From MicrosoftDocs/Agent-Skills, a repository with 682 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.