microsoft-docs
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.
- Installs
- 81
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/microsoft/ai-agents-for-beginners --skill microsoft-docs- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads microsoft-docs automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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.
Exceptions: When to Use Other Tools
The following categories live outside learn.microsoft.com. Use the specified tool instead.
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.
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 |
/microsoft/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):
- Call
mcp_context7_resolve-library-idwith the technology name - Call
mcp_context7_query-docswith the returned library ID and a specific query
Writing Effective Queries
Be specific — include version, intent, and language:
# ❌ Too broad
"Azure Functions"
"agent framework"
# ✅ Specific
"Azure Functions Python v2 programming model"
"Cosmos DB partition key design best practices"
"GitHub Actions workflow_dispatch inputs matrix strategy"
"Aspire AddUvicornApp Python FastAPI integration"
"DevUI serve agents tracing OpenTelemetry directory discovery"
"Agent Framework workflow conditional edges branching handoff"
Include context:
- Version when relevant (
.NET 8,Aspire 13,VS Code 1.96) - Task intent (
quickstart,tutorial,overview,limits,API reference) - Language for polyglot docs (
Python,TypeScript,C#)
FAQ
What does the microsoft-docs skill do?
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.
How do I install microsoft-docs?
Run npx skills add https://github.com/microsoft/ai-agents-for-beginners --skill microsoft-docs in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/microsoft-docs/ (personal) or .claude/skills/microsoft-docs/ (project).
Which AI agents can use microsoft-docs?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is microsoft-docs safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains microsoft-docs?
It is published by microsoft in microsoft/ai-agents-for-beginners, and it is an official skill from the maker of the technology it covers. It has 81 recorded installs.
More from microsoft/ai-agents-for-beginners
jupyter-notebook
microsoft/ai-agents-for-beginners
Open the skill to read its SKILL.md instructions.
Popular docs & writing skills
grill-with-docs
mattpocock/skills
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
lark-markdown
open.feishu.cn
飞书 Markdown：查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件，或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档，也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。
writing-beats
mattpocock/skills
Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.
writing-shape
mattpocock/skills
Writing, exploit: shape raw material into an article, paragraph by paragraph.
writing-fragments
mattpocock/skills
Writing, explore: mine raw fragments, no structure yet.
writing-for-agents
mattpocock/skills
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.