microsoft-docs - SKILL.md Agent Skill

name: microsoft-docs description: Na to search official Microsoft documentation make you fit find concepts, tutorials, and code examples for Azure, .NET, Agent Framework, Aspire, VS Code, GitHub, and plenty more. E dey use Microsoft Learn MCP as the default, together with Context7 and Aspire MCP for content wey dey outside learn.microsoft.com.

Microsoft Docs

Skill wey you fit use to do research for the Microsoft technology ecosystem. E cover learn.microsoft.com and documentation wey dey outside am (VS Code, GitHub, Aspire, Agent Framework repos).

Di Default: Microsoft Learn MCP

Use these tools for everytin for learn.microsoft.com — Azure, .NET, M365, Power Platform, Agent Framework, Semantic Kernel, Windows, and more. Na dis one be di main tool for most Microsoft documentation questions.

Tool	Wetin e dey do
`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 if you need full tutorials, all config options, or when search excerpts don cut.

Exceptions: When to Use Other Tools

Di categories wey follow dey live outside learn.microsoft.com. Use di tool wey dem specify instead.

.NET Aspire — Use Aspire MCP Server (wey better) or Context7

Aspire docs dey for aspire.dev, no for Learn. Di best tool depend on your Aspire CLI version:

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

MCP Tool	Wetin e dey do
`list_docs`	List all di documentation wey dey for aspire.dev
`search_docs`	Weighted lexical search across aspire.dev content
`get_doc`	Retrieve specific document by slug

Dem ship dis for 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 no 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 dey for code.visualstudio.com, no for 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 dey for 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 dey for learn.microsoft.com (use microsoft_docs_search), but di GitHub repo get API-level detail wey dey ahead of wetin dem publish — especially 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 di Learn website source for how-to guides first, then check di 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-id with di technology name
Call mcp_context7_query-docs with di returned library ID and a specific query

Writing Effective Queries

Make e 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 e relevant (.NET 8, Aspire 13, VS Code 1.96)
Task intent (quickstart, tutorial, overview, limits, API reference)
Language for polyglot docs (Python, TypeScript, C#)

Disclaimer: Dis dokument na AI translate — we take Co‑op Translator (https://github.com/Azure/co-op-translator). Even though we dey try make am correct, make you sabi say automated translations fit get mistakes or no 100% accurate. The original dokument for im original language na the correct/official source. If na important matter, make you use professional human translator. We no go responsible for any misunderstanding or wrong interpretation wey fit come from dis translation.