$npx -y skills add github/awesome-copilot --skill microsoft-docsmicrosoft-docs is an agent skill published from github/awesome-copilot, installable through the skills CLI.
| 1 | # Microsoft Docs |
| 2 | |
| 3 | Research skill for the Microsoft technology ecosystem. Covers learn.microsoft.com and documentation that lives outside it (VS Code, GitHub, Aspire, Agent Framework repos). |
| 4 | |
| 5 | --- |
| 6 | |
| 7 | ## Default: Microsoft Learn MCP |
| 8 | |
| 9 | Use these tools for **everything on learn.microsoft.com** — Azure, .NET, M365, Power Platform, Agent Framework, Semantic Kernel, Windows, and more. This is the primary tool for the vast majority of Microsoft documentation queries. |
| 10 | |
| 11 | | Tool | Purpose | |
| 12 | |------|---------| |
| 13 | | `microsoft_docs_search` | Search learn.microsoft.com — concepts, guides, tutorials, configuration | |
| 14 | | `microsoft_code_sample_search` | Find working code snippets from Learn docs. Pass `language` (`python`, `csharp`, etc.) for best results | |
| 15 | | `microsoft_docs_fetch` | Get full page content from a specific URL (when search excerpts aren't enough) | |
| 16 | |
| 17 | Use `microsoft_docs_fetch` after search when you need complete tutorials, all config options, or when search excerpts are truncated. |
| 18 | |
| 19 | ### CLI Alternative |
| 20 | |
| 21 | If the Learn MCP server is not available, use the `mslearn` CLI from your terminal or shell (for example, Bash, PowerShell, or cmd) instead: |
| 22 | |
| 23 | ```bash |
| 24 | # Run directly (no install needed) |
| 25 | npx @microsoft/learn-cli search "BlobClient UploadAsync Azure.Storage.Blobs" |
| 26 | |
| 27 | # Or install globally, then run |
| 28 | npm install -g @microsoft/learn-cli |
| 29 | mslearn search "BlobClient UploadAsync Azure.Storage.Blobs" |
| 30 | ``` |
| 31 | |
| 32 | | MCP Tool | CLI Command | |
| 33 | |----------|-------------| |
| 34 | | `microsoft_docs_search(query: "...")` | `mslearn search "..."` | |
| 35 | | `microsoft_code_sample_search(query: "...", language: "...")` | `mslearn code-search "..." --language ...` | |
| 36 | | `microsoft_docs_fetch(url: "...")` | `mslearn fetch "..."` | |
| 37 | |
| 38 | Pass `--json` to `search` or `code-search` to get raw JSON output for further processing. |
| 39 | |
| 40 | --- |
| 41 | |
| 42 | ## Exceptions: When to Use Other Tools |
| 43 | |
| 44 | The following categories live **outside** learn.microsoft.com. Use the specified tool instead. |
| 45 | |
| 46 | ### .NET Aspire — Use Aspire MCP Server (preferred) or Context7 |
| 47 | |
| 48 | Aspire docs live on **aspire.dev**, not Learn. The best tool depends on your Aspire CLI version: |
| 49 | |
| 50 | **CLI 13.2+** (recommended) — The Aspire MCP server includes built-in docs search tools: |
| 51 | |
| 52 | | MCP Tool | Description | |
| 53 | |----------|-------------| |
| 54 | | `list_docs` | Lists all available documentation from aspire.dev | |
| 55 | | `search_docs` | Weighted lexical search across aspire.dev content | |
| 56 | | `get_doc` | Retrieves a specific document by slug | |
| 57 | |
| 58 | These ship in Aspire CLI 13.2 ([PR #14028](https://github.com/dotnet/aspire/pull/14028)). To update: `aspire update --self --channel daily`. Ref: https://davidpine.dev/posts/aspire-docs-mcp-tools/ |
| 59 | |
| 60 | **CLI 13.1** — The MCP server provides integration lookup (`list_integrations`, `get_integration_docs`) but **not** docs search. Fall back to Context7: |
| 61 | |
| 62 | | Library ID | Use for | |
| 63 | |---|---| |
| 64 | | `/microsoft/aspire.dev` | Primary — guides, integrations, CLI reference, deployment | |
| 65 | | `/dotnet/aspire` | Runtime source — API internals, implementation details | |
| 66 | | `/communitytoolkit/aspire` | Community integrations — Go, Java, Node.js, Ollama | |
| 67 | |
| 68 | ### VS Code — Use Context7 |
| 69 | |
| 70 | VS Code docs live on **code.visualstudio.com**, not Learn. |
| 71 | |
| 72 | | Library ID | Use for | |
| 73 | |---|---| |
| 74 | | `/websites/code_visualstudio` | User docs — settings, features, debugging, remote dev | |
| 75 | | `/websites/code_visualstudio_api` | Extension API — webviews, TreeViews, commands, contribution points | |
| 76 | |
| 77 | ### GitHub — Use Context7 |
| 78 | |
| 79 | GitHub docs live on **docs.github.com** and **cli.github.com**. |
| 80 | |
| 81 | | Library ID | Use for | |
| 82 | |---|---| |
| 83 | | `/websites/github_en` | Actions, API, repos, security, admin, Copilot | |
| 84 | | `/websites/cli_github` | GitHub CLI (`gh`) commands and flags | |
| 85 | |
| 86 | ### Agent Framework — Use Learn MCP + Context7 |
| 87 | |
| 88 | Agent Framework tutorials are on learn.microsoft.com (use `microsoft_docs_search`), but the **GitHub repo** has API-level detail that is often ahead of published docs — particularly DevUI REST API reference, CLI options, and .NET integration. |
| 89 | |
| 90 | | Library ID | Use for | |
| 91 | |---|---| |
| 92 | | `/websites/learn_microsoft_en-us_agent-framework` | Tutorials — DevUI guides, tracing, workflow orchestration | |
| 93 | | `/microsoft/agent-framework` | API detail — DevUI REST endpoints, CLI flags, auth, .NET `AddDevUI`/`MapDevUI` | |
| 94 | |
| 95 | **DevUI tip:** Query the Learn website source for how-to guides, then the repo source for API-level specifics (endpoint schemas, proxy config, auth tokens). |
| 96 | |
| 97 | --- |
| 98 | |
| 99 | ## Context7 Setup |
| 100 | |
| 101 | For any Context7 query, resolve the library ID first (one-time per session): |
| 102 | |
| 103 | 1. Call `mcp_context7_resolve-library-id` with the technology name |
| 104 | 2. Call `mcp_context7_query-docs` with the returned library ID and a specific query |
| 105 | |
| 106 | --- |
| 107 | |
| 108 | ## Writing Effective Queries |
| 109 | |
| 110 | Be specific — in |