microsoft-docs · microsoft — Claude Code skill: what it does, how to install
microsoft-docs answers questions about Microsoft technologies using official documentation. Use it for tutorials, settings, quotas, limits, and concept explanations.
npx skills add microsoft/skills --skill microsoft-docs -a claude-codeWhat microsoft-docs does
microsoft-docs lets an agent search and read official Microsoft documentation. It covers Azure, .NET, M365, Windows, and Power Platform, with use cases ranging from concept questions to step-by-step tutorials, configuration options, quotas, and security practices.
The main path uses the Microsoft Learn MCP Server with microsoft_docs_search and microsoft_docs_fetch. Search finds relevant pages and guides; fetch retrieves full content or a selected section. When the MCP server is unavailable, the skill falls back to mslearn, either through npx @microsoft/learn-cli or the globally installed command.
Install it when your agent should check Microsoft Learn while answering technical questions. For Claude Code, run npx skills add microsoft/skills --skill microsoft-docs -a claude-code; for GitHub Copilot, use gh skill install microsoft/skills microsoft-docs.
What it helps with
- find an official Azure Functions tutorial
- understand App Service configuration settings
- check Microsoft service limits and quotas
- explain how Cosmos DB partitioning works
- look up Azure security best practices
Example prompts for the agent
- Explain how Cosmos DB partitioning works and find the official documentation.
- Find a step-by-step tutorial for the Azure Functions Python v2 programming model.
- Check the App Service configuration settings and Azure OpenAI rate limits.
How to install microsoft-docs
1Skills CLI (Vercel)
npx skills add microsoft/skills --skill microsoft-docs -a claude-code2Manually: put the files in place
~/.claude/skills/microsoft-docs/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/microsoft-docs/
Manually: put the files in place
.agents/skills/microsoft-docs/SKILL.mdFor all projects use ~/.agents/skills/
Manually: put the files in place
.cursor/skills/microsoft-docs/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install microsoft/skills microsoft-docs2Manually: put the files in place
.github/skills/microsoft-docs/SKILL.mdPlatform CLI
gemini skills install https://github.com/microsoft/skills --path .github/skills/microsoft-docsManually: put the files in place
.devin/skills/microsoft-docs/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set18
The whole set →Other versions of microsoft-docs
Similar
Questions about microsoft-docs
How do I install microsoft-docs in Claude Code?
Run npx skills add microsoft/skills --skill microsoft-docs -a claude-code. The skill file is placed at ~/.claude/skills/microsoft-docs/SKILL.md.
What does microsoft-docs do?
It searches official Microsoft documentation and fetches full pages when search excerpts are insufficient. The skill covers concepts, tutorials, configuration, limits, quotas, and best practices.
What does microsoft-docs need to work?
It primarily uses the Microsoft Learn MCP Server. If that server is unavailable, use npx @microsoft/learn-cli or install the CLI with npm install -g @microsoft/learn-cli.
Source text
SKILL.md · MIT
--- name: microsoft-docs description: Understand Microsoft technologies by querying official documentation. Use whenever the user asks how something works, wants tutorials, needs configuration options, limits, quotas, or best practices for any Microsoft technology (Azure, .NET, M365, Windows, Power Platform, etc.)—even if they don't mention "docs." If the question is about understanding a concept rather than writing code, this is the right skill. context: fork compatibility: Primarily uses the Microsoft Learn MCP Server (https://learn.microsoft.com/api/mcp); if that is unavailable, fall back to the mslearn CLI (`npx @microsoft/learn-cli`). --- # Microsoft Docs ## Tools | Tool | Use For | |------|---------| | `microsoft_docs_search` | Find documentation—concepts, guides, tutorials, configuration | | `microsoft_docs_fetch` | Get full page content (when search excerpts aren't enough) | ## When to Use - **Understanding concepts** — "How does Cosmos DB partitioning work?" - **Learning a service** — "Azure Functions overview", "Container Apps architecture" - **Finding tutorials** — "quickstart", "getting started", "step-by-step" - **Configuration options** — "App Service configuration settings" - **Limits & quotas** — "Azure OpenAI rate limits", "Service Bus quotas" - **Best practices** — "Azure security best practices" ## Query Effectiveness Good queries are specific: ``` # ❌ Too broad "Azure Functions" # ✅ Specific "Azure Functions Python v2 programming model" "Cosmos DB partition key design best practices" "Container Apps scaling rules KEDA" ``` Include context: - **Version** when relevant (`.NET 8`, `EF Core 8`) - **Task intent** (`quickstart`, `tutorial`, `overview`, `limits`) - **Platform** for multi-platform docs (`Linux`, `Windows`) ## When to Fetch Full Page Fetch after search when: - **Tutorials** — need complete step-by-step instructions - **Configuration guides** — need all options listed - **Deep dives** — user wants comprehensive coverage - **Search excerpt is cut off** — full context needed ## Why Use This - **Accuracy** — live docs, not training data that may be outdated - **Completeness** — tutorials have all steps, not fragments - **Authority** — official Microsoft documentation ## CLI Alternative If the Learn MCP server is not available, use the `mslearn` CLI from the command line instead: ```sh # Run directly (no install needed) npx @microsoft/learn-cli search "azure functions timeout" # Or install globally, then run npm install -g @microsoft/learn-cli mslearn search "azure functions timeout" ``` | MCP Tool | CLI Command | |----------|-------------| | `microsoft_docs_search(query: "...")` | `mslearn search "..."` | | `microsoft_docs_fetch(url: "...")` | `mslearn fetch "..."` | The `fetch` command also supports `--section <heading>` to extract a single section and `--max-chars <number>` to truncate output.
© microsoft · MIT · microsoft/skills