microsoft-docs skill: search official Microsoft docs from your agent

Makes your agent look up official Microsoft documentation and code samples before it answers.

Installs: 14.9K; on skills.sh
Stars: 40.7K; on GitHub
Updated: Oct 2026; last repo commit

This skill sends your agent to the Microsoft Learn MCP tools first for anything on learn.microsoft.com: Azure, .NET, M365, Power Platform and more. For docs that live elsewhere it names the right tool: Aspire's own MCP server, or Context7 for VS Code, GitHub and Agent Framework repo docs.

It triggers on questions about Microsoft technologies. It does not bundle the tools it uses. You need the Microsoft Learn MCP server, or the mslearn command line the SKILL.md gives as the fallback, and Context7 for the outside docs.

Good for

.NET and Azure developers who need current docs, not memory
Developers working with .NET Aspire, Agent Framework or Semantic Kernel
Anyone who wants code samples taken from Microsoft Learn

Install microsoft-docs

Claude Code

Copy this prompt.

Install the microsoft-docs skill in Claude Code. Run this command:

/plugin install microsoft-docs@claude-plugins-official

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

This skill only tells the agent which tools to call; it does not install them. The Learn MCP endpoint is https://learn.microsoft.com/api/mcp and needs no key, per the Learn MCP README. Context7 and the Aspire MCP server are separate servers the SKILL.md also names; add them yourself if you want docs outside learn.microsoft.com. Pick the plugin, or the skills CLI plus your own Learn MCP setup. The README says the plugin includes the MCP server and skills; its copy of the skill comes from MicrosoftDocs/mcp, not from the awesome-copilot folder this page describes. The third method is the SKILL.md fallback and needs no MCP server.

From the project README. Source.

What's in the skill

When it loads

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.

Sections in SKILL.md

Default: Microsoft Learn MCP
CLI Alternative
Exceptions: When to Use Other Tools
.NET Aspire — Use Aspire MCP Server (preferred) or Context7
VS Code — Use Context7
GitHub — Use Context7
Agent Framework — Use Learn MCP + Context7
Context7 Setup
Writing Effective Queries

Key facts

Author: GitHub (github/awesome-copilot, a community collection; the skill author is not named in the SKILL.md)
Repo: github/awesome-copilot, folder skills/microsoft-docs
Installs on skills.sh: 14,930 as of 2 Nov 2026
GitHub stars: 40,666 for the whole github/awesome-copilot repo, 2 Nov 2026
License: MIT (awesome-copilot repo)
Last commit in the repo: 2026-10-30
What is inside: 1 file (SKILL.md only)
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk pass
Needs: Microsoft Learn MCP server or the mslearn CLI; Context7 and the Aspire MCP server for docs outside Learn

What it includes

Searches learn.microsoft.com
Finds concepts, guides, tutorials and configuration pages.
Try: “Cosmos DB partition key design best practices.”
Network · microsoft_docs_search
Finds working code snippets in Learn docs
Takes a language such as python or csharp for better results.
Network · microsoft_code_sample_search
Gets the full text of a Learn page
Used after a search when excerpts are cut off.
Network · microsoft_docs_fetch
npx @microsoft/learn-cli search, code-search, fetch
If the Learn MCP server is missing, the same three actions run from a terminal. It runs through npx or a global npm install.
Runs code · mslearn CLI fallback
list_docs, search_docs, get_doc on the Aspire MCP server
For aspire.dev docs with Aspire CLI 13.2 or later. On 13.1 it falls back to Context7 library IDs.
Network · Aspire docs tools
Resolves a library ID, then queries its docs
Used for VS Code, GitHub, GitHub CLI and the Agent Framework repo, with listed library IDs.
Network · Context7 lookups
Be specific: version, intent and language
Examples include "Azure Functions Python v2 programming model" and "GitHub Actions workflow_dispatch inputs matrix strategy".
Read · Writing effective queries

From the official docs

Permissions

Low risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

The fallback runs an npm package
Without the MCP server the skill runs @microsoft/learn-cli through npx or a global install. Install it yourself first if you want to see what it adds. github.com
One tip updates your Aspire CLI
For Aspire docs search the SKILL.md suggests aspire update --self --channel daily, which moves the Aspire CLI to the daily channel. Skip it if you want a stable build. github.com
Third-party content from a community collection
The awesome-copilot README says its customizations come from third-party developers and asks you to inspect them before installing. Read the SKILL.md first. github.com
The Claude Code plugin route adds an MCP server and 3 skills
The MicrosoftDocs/mcp repo's Claude plugin manifest declares no hooks, and its .mcp.json adds one remote HTTP server, microsoft-learn at https://learn.microsoft.com/api/mcp. The README lists 3 skills for the plugin: microsoft-docs, microsoft-code-reference and microsoft-skill-creator. github.com

Technical details

Turning on read-only	The SKILL.md defines no read-only switch.
Talks to	learn.microsoft.com through the Learn MCP server or the mslearn CLI. Context7, for VS Code, GitHub and Agent Framework docs. The Aspire MCP server, for aspire.dev docs. learn.microsoft.com/api/mcp, when the Learn MCP server is added
Scopes	Calls Microsoft Learn, Aspire and Context7 documentation tools Can run npx @microsoft/learn-cli, or npm install -g @microsoft/learn-cli

Questions

What does the microsoft-docs skill do?

It makes your agent search official Microsoft documentation and code samples, mainly through the Microsoft Learn MCP tools, and use other named tools for docs that live outside Learn.

How do I install it?

Install the skill folder from the install box, then add the Microsoft Learn MCP server, because the skill does not set up the tools it calls. In Claude Code the Learn MCP README gives /plugin install microsoft-docs@claude-plugins-official, which includes the MCP server and skills. Other clients have their own steps in the install box.

Do I need the MCP server?

Not strictly. If the Learn MCP server is not available, the SKILL.md says to use the mslearn CLI, run with npx @microsoft/learn-cli or installed globally with npm.

What is Context7 for here?

Context7 serves docs that are not on learn.microsoft.com, such as VS Code, GitHub, and the Agent Framework repo. It is a separate MCP server you add yourself.

Is it safe to run?

The skill bundles no scripts, but it sends your search queries to the Learn MCP server (or the mslearn CLI), and to Context7 and the Aspire MCP server when it uses them. The CLI fallback runs an npm package through npx, and one tip suggests moving your Aspire CLI to the daily channel. See the Watch out list for both.

Information

updated Nov 2, 2026

Repository: github/awesome-copilot
Folder: skills/microsoft-docs

github/awesome-copilot skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5

Microsoft Learn MCP server README · github.com
microsoft-docs SKILL.md · github.com
awesome-copilot README · github.com
Learn MCP plugin .mcp.json · github.com
Learn MCP Claude plugin manifest · github.com