thedixitjain 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-idwith di technology name - Call
mcp_context7_query-docswith 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.
Source: microsoft/ai-agents-for-beginners → translations/pcm/.agents/skills/microsoft-docs/SKILL.md