microsoft-docs

Query official Microsoft documentation for concepts, tutorials, and code samples across Azure, .NET, and related platforms.

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/miyake-san/sogo-agent-platform --skill microsoft-docs-miyake-san
Or copy as Structured Prompt for Agentâ–¼
Please help me install this Agent Skill.
Skill: microsoft-docs
Source: https://github.com/miyake-san/sogo-agent-platform/tree/main/skills/core/microsoft-docs
Command: npx skills add https://github.com/miyake-san/sogo-agent-platform --skill microsoft-docs-miyake-san

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @microsoft/learn-cli.

What problem does it solve? Finding accurate, up-to-date Microsoft documentation is fragmented across learn.microsoft.com, aspire.dev, code.visualstudio.com, and docs.github.com. This Skill routes each query to the correct documentation source so you get authoritative answers without manually hunting across sites. ## Core Features & Use Cases - Microsoft Learn MCP Integration: Search learn.microsoft.com, find code samples by language, and fetch full page content for Azure, .NET, M365, Agent Framework, and more. - Source Routing for Exceptions: Directs Aspire queries to the Aspire MCP server or Context7, VS Code and GitHub queries to Context7 library IDs, and Agent Framework queries to both Learn and the GitHub repo. - CLI Fallback: Uses the mslearn CLI (npx @microsoft/learn-cli) when the Learn MCP server is unavailable. - Use Case: You need the Python v2 programming model for Azure Functions plus a working BlobClient upload sample. The Skill searches Learn, retrieves the code snippet in Python, and fetches the full tutorial page when excerpts are insufficient. ## Quick Start Ask the agent to find the Azure Functions Python v2 programming model documentation and a code sample for uploading blobs with BlobClient.

Frequently Asked Questions about microsoft-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search Microsoft Learn documentation from an AI agent?â–¼

Use the Microsoft Learn MCP server tools: microsoft_docs_search for concepts and guides, microsoft_code_sample_search for language-specific code snippets, and microsoft_docs_fetch to retrieve full page content when search excerpts are insufficient.

What tool should I use for .NET Aspire documentation?â–¼

Aspire docs live on aspire.dev, not Learn. With Aspire CLI 13.2+, use the Aspire MCP server's list_docs, search_docs, and get_doc tools. On CLI 13.1, fall back to Context7 with the /microsoft/aspire.dev library ID.

Can I search Microsoft docs without the Learn MCP server?â–¼

Yes, use the mslearn CLI as a fallback. Run npx @microsoft/learn-cli search "your query" without installation, or install globally with npm install -g @microsoft/learn-cli. It supports search, code-search, and fetch commands mirroring the MCP tools.

Does this cover VS Code and GitHub documentation?â–¼

Yes, but through Context7 since those docs live outside learn.microsoft.com. Use /websites/code_visualstudio for VS Code user docs, /websites/code_visualstudio_api for extension APIs, /websites/github_en for GitHub, and /websites/cli_github for the gh CLI.

Why do some Microsoft documentation searches return incomplete results?â–¼

Search excerpts are often truncated or the content lives outside learn.microsoft.com. Use microsoft_docs_fetch on the specific URL for complete pages, and route Aspire, VS Code, and GitHub queries to Context7 or the Aspire MCP server instead.