Skip to content
Skillpedia
Documentation40k · #5234

microsoft-docs

Lets your agent query official Microsoft documentation. It can find concepts, tutorials, and code examples for various Microsoft technologies.

What it does

This tool helps you find information about Microsoft technologies like Azure, .NET, and VS Code. It searches official websites for guides, tutorials, and code examples.

When to use it

  • ✓When you need to learn about an Azure service.
  • ✓When looking for a tutorial to develop with .NET.
  • ✓When you want to understand how to use VS Code or GitHub.

Example of what to ask your AI

“How to configure CORS in Azure Functions?”

Want more? Open the sections below.

How to use

The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.

Skill link

https://github.com/github/awesome-copilot/blob/main/skills/microsoft-docs/SKILL.md

Ready-to-paste message

Use this skill to help me: https://github.com/github/awesome-copilot/blob/main/skills/microsoft-docs/SKILL.md Read the SKILL.md file at that link and follow its instructions for my task.
How it works

The tool searches various Microsoft documentation sources. For most things, it uses Microsoft Learn. For others, like VS Code or GitHub, it uses specific sources.

Installation

Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.

In the terminal (Claude Code, Codex, Cursor), in your project folder:

npx skills add github/awesome-copilot --skill microsoft-docs

Or download just the file:

curl -L https://raw.githubusercontent.com/github/awesome-copilot/main/skills/microsoft-docs/SKILL.md -o SKILL.md
Technical content (original SKILL.md)

Original text by the author, straight from GitHub.

Microsoft Docs

Research skill for the Microsoft technology ecosystem. Covers learn.microsoft.com and documentation that lives outside it (VS Code, GitHub, Aspire, Agent Framework repos).


Default: Microsoft Learn MCP

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.

Tool Purpose
microsoft_docs_search Search learn.microsoft.com — concepts, guides, tutorials, configuration
microsoft_code_sample_search Find working code snippets from Learn docs. Pass language (python, csharp, etc.) for best results
microsoft_docs_fetch Get full page content from a specific URL (when search excerpts aren't enough)

Use microsoft_docs_fetch after search when you need complete tutorials, all config options, or when search excerpts are truncated.

CLI Alternative

If the Learn MCP server is not available, use the mslearn CLI from your terminal or shell (for example, Bash, PowerShell, or cmd) instead:

# Run directly (no install needed)
npx @microsoft/learn-cli search "BlobClient UploadAsync Azure.Storage.Blobs"

# Or install globally, then run
npm install -g @microsoft/learn-cli
mslearn search "BlobClient UploadAsync Azure.Storage.Blobs"
MCP Tool CLI Command
microsoft_docs_search(query: "...") mslearn search "..."
microsoft_code_sample_search(query: "...", language: "...") mslearn code-search "..." --language ...
microsoft_docs_fetch(url: "...") mslearn fetch "..."

Pass --json to search or code-search to get raw JSON output for further processing.


Exceptions: When to Use Other Tools

The following categories live outside learn.microsoft.com. Use the specified tool instead.

.NET Aspire — Use Aspire MCP Server (preferred) or Context7

Aspire docs live on aspire.dev, not Learn. The best tool depends on your Aspire CLI version:

CLI 13.2+ (recommended) — The Aspire MCP server includes built-in docs search tools:

MCP Tool Description
list_docs Lists all available documentation from aspire.dev
search_docs Weighted lexical search across aspire.dev content
get_doc Retrieves a specific document by slug

These ship in Aspire CLI 13.2 (PR #14028). To update: aspire update --self --channel daily. Ref: https://davidpine.dev/posts/aspire-docs-mcp-tools/

CLI 13.1 — The MCP server provides integration lookup (list_integrations, get_integration_docs) but not docs search. Fall back to Context7:

Library ID Use for
/microsoft/aspire.dev Primary — guides, integrations, CLI reference, deployment
/dotnet/aspire Runtime source — API internals, implementation details
/communitytoolkit/aspire Community integrations — Go, Java, Node.js, Ollama

VS Code — Use Context7

VS Code docs live on code.visualstudio.com, not Learn.

Library ID Use for
/websites/code_visualstudio User docs — settings, features, debugging, remote dev
/websites/code_visualstudio_api Extension API — webviews, TreeViews, commands, contribution points

GitHub — Use Context7

GitHub docs live on docs.github.com and cli.github.com.

Library ID Use for
/websites/github_en Actions, API, repos, security, admin, Copilot
/websites/cli_github GitHub CLI (gh) commands and flags

Agent Framework — Use Learn MCP + Context7

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.

Library ID Use for
/websites/learn_microsoft_en-us_agent-framework Tutorials — DevUI guides, tracing, workflow orchestration
/microsoft/agent-framework API detail — DevUI REST endpoints, CLI flags, auth, .NET AddDevUI/MapDevUI

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


Context7 Setup

For any Context7 query, resolve the library ID first (one-time per session):

…

FAQ

What is Microsoft Learn?

It's Microsoft's official website with all documentation, guides, and tutorials about their products and services.

What are 'concepts', 'tutorials', and 'code examples'?

Concepts explain what something is, tutorials show how to do something step-by-step, and code examples are ready-to-use snippets.

Do I need to know the exact technology version?

Knowing the version (e.g., .NET 8) is helpful for more precise information, but the tool can assist even without it.

Details

Original description by the author

Query official Microsoft documentation to find concepts, tutorials, and code examples across Azure, .NET, Agent Framework, Aspire, VS Code, GitHub, and more. Uses Microsoft Learn MCP as the default, with Context7 and Aspire MCP for content that lives outside learn.microsoft.com.

repo: github/awesome-copilot

Popularity

GitHub stars
40k
Ranking position
#5234
License
MIT
Updated
10/15/2026

Is this skill useful?

0

Sign in to vote.

Comments

  • …

More skills from this repository

Similar skills