{"id":"6002cbe6-38ca-432a-9b58-9101d8ce9b73","shortId":"TQy2EZ","kind":"skill","title":"microsoft-docs","tagline":"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.","description":"# Microsoft Docs\n\nResearch skill for the Microsoft technology ecosystem. Covers learn.microsoft.com and documentation that lives outside it (VS Code, GitHub, Aspire, Agent Framework repos).\n\n---\n\n## Default: Microsoft Learn MCP\n\nUse 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.\n\n| Tool | Purpose |\n|------|---------|\n| `microsoft_docs_search` | Search learn.microsoft.com — concepts, guides, tutorials, configuration |\n| `microsoft_code_sample_search` | Find working code snippets from Learn docs. Pass `language` (`python`, `csharp`, etc.) for best results |\n| `microsoft_docs_fetch` | Get full page content from a specific URL (when search excerpts aren't enough) |\n\nUse `microsoft_docs_fetch` after search when you need complete tutorials, all config options, or when search excerpts are truncated.\n\n### CLI Alternative\n\nIf the Learn MCP server is not available, use the `mslearn` CLI from your terminal or shell (for example, Bash, PowerShell, or cmd) instead:\n\n```bash\n# Run directly (no install needed)\nnpx @microsoft/learn-cli search \"BlobClient UploadAsync Azure.Storage.Blobs\"\n\n# Or install globally, then run\nnpm install -g @microsoft/learn-cli\nmslearn search \"BlobClient UploadAsync Azure.Storage.Blobs\"\n```\n\n| MCP Tool | CLI Command |\n|----------|-------------|\n| `microsoft_docs_search(query: \"...\")` | `mslearn search \"...\"` |\n| `microsoft_code_sample_search(query: \"...\", language: \"...\")` | `mslearn code-search \"...\" --language ...` |\n| `microsoft_docs_fetch(url: \"...\")` | `mslearn fetch \"...\"` |\n\nPass `--json` to `search` or `code-search` to get raw JSON output for further processing.\n\n---\n\n## Exceptions: When to Use Other Tools\n\nThe following categories live **outside** learn.microsoft.com. Use the specified tool instead.\n\n### .NET Aspire — Use Aspire MCP Server (preferred) or Context7\n\nAspire docs live on **aspire.dev**, not Learn. The best tool depends on your Aspire CLI version:\n\n**CLI 13.2+** (recommended) — The Aspire MCP server includes built-in docs search tools:\n\n| MCP Tool | Description |\n|----------|-------------|\n| `list_docs` | Lists all available documentation from aspire.dev |\n| `search_docs` | Weighted lexical search across aspire.dev content |\n| `get_doc` | Retrieves a specific document by slug |\n\nThese ship in Aspire CLI 13.2 ([PR #14028](https://github.com/dotnet/aspire/pull/14028)). To update: `aspire update --self --channel daily`. Ref: https://davidpine.dev/posts/aspire-docs-mcp-tools/\n\n**CLI 13.1** — The MCP server provides integration lookup (`list_integrations`, `get_integration_docs`) but **not** docs search. Fall back to Context7:\n\n| Library ID | Use for |\n|---|---|\n| `/microsoft/aspire.dev` | Primary — guides, integrations, CLI reference, deployment |\n| `/dotnet/aspire` | Runtime source — API internals, implementation details |\n| `/communitytoolkit/aspire` | Community integrations — Go, Java, Node.js, Ollama |\n\n### VS Code — Use Context7\n\nVS Code docs live on **code.visualstudio.com**, not Learn.\n\n| Library ID | Use for |\n|---|---|\n| `/websites/code_visualstudio` | User docs — settings, features, debugging, remote dev |\n| `/websites/code_visualstudio_api` | Extension API — webviews, TreeViews, commands, contribution points |\n\n### GitHub — Use Context7\n\nGitHub docs live on **docs.github.com** and **cli.github.com**.\n\n| Library ID | Use for |\n|---|---|\n| `/websites/github_en` | Actions, API, repos, security, admin, Copilot |\n| `/websites/cli_github` | GitHub CLI (`gh`) commands and flags |\n\n### Agent Framework — Use Learn MCP + Context7\n\nAgent 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.\n\n| Library ID | Use for |\n|---|---|\n| `/websites/learn_microsoft_en-us_agent-framework` | Tutorials — DevUI guides, tracing, workflow orchestration |\n| `/microsoft/agent-framework` | API detail — DevUI REST endpoints, CLI flags, auth, .NET `AddDevUI`/`MapDevUI` |\n\n**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).\n\n---\n\n## Context7 Setup\n\nFor any Context7 query, resolve the library ID first (one-time per session):\n\n1. Call `mcp_context7_resolve-library-id` with the technology name\n2. Call `mcp_context7_query-docs` with the returned library ID and a specific query\n\n---\n\n## Writing Effective Queries\n\nBe specific — include version, intent, and language:\n\n```\n# ❌ Too broad\n\"Azure Functions\"\n\"agent framework\"\n\n# ✅ Specific\n\"Azure Functions Python v2 programming model\"\n\"Cosmos DB partition key design best practices\"\n\"GitHub Actions workflow_dispatch inputs matrix strategy\"\n\"Aspire AddUvicornApp Python FastAPI integration\"\n\"DevUI serve agents tracing OpenTelemetry directory discovery\"\n\"Agent Framework workflow conditional edges branching handoff\"\n```\n\nInclude context:\n- **Version** when relevant (`.NET 8`, `Aspire 13`, `VS Code 1.96`)\n- **Task intent** (`quickstart`, `tutorial`, `overview`, `limits`, `API reference`)\n- **Language** for polyglot docs (`Python`, `TypeScript`, `C#`)","tags":["microsoft","docs","awesome","copilot","github","agent-skills","agents","custom-agents","github-copilot","hacktoberfest","prompt-engineering"],"capabilities":["skill","source-github","skill-microsoft-docs","topic-agent-skills","topic-agents","topic-awesome","topic-custom-agents","topic-github-copilot","topic-hacktoberfest","topic-prompt-engineering"],"categories":["awesome-copilot"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/github/awesome-copilot/microsoft-docs","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add github/awesome-copilot","source_repo":"https://github.com/github/awesome-copilot","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 33270 github stars · SKILL.md body (5,346 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:52:17.138Z","embedding":null,"createdAt":"2026-04-18T20:25:12.428Z","updatedAt":"2026-05-18T18:52:17.138Z","lastSeenAt":"2026-05-18T18:52:17.138Z","tsv":"'/communitytoolkit/aspire':410 '/dotnet/aspire':403 '/dotnet/aspire/pull/14028)).':359 '/microsoft/agent-framework':530 '/microsoft/aspire.dev':396 '/posts/aspire-docs-mcp-tools/':370 '/websites/cli_github':470 '/websites/code_visualstudio':433 '/websites/code_visualstudio_api':441 '/websites/github_en':463 '/websites/learn_microsoft_en-us_agent-framework':523 '1':585 '1.96':680 '13':677 '13.1':372 '13.2':309,354 '14028':356 '2':597 '8':675 'across':15,338 'action':464,644 'adddevui':540 'adduvicornapp':651 'admin':468 'agent':18,65,84,477,483,627,657,662 'ahead':505 'altern':172 'api':406,443,465,499,512,531,560,687 'api-level':498,559 'aren':148 'aspir':20,36,64,284,286,292,305,312,352,362,650,676 'aspire.dev':296,332,339 'auth':538,567 'avail':180,329 'azur':16,79,625,630 'azure.storage.blobs':208,222 'back':389 'bash':192,197 'best':132,300,641 'blobclient':206,220 'branch':667 'broad':624 'built':317 'built-in':316 'c':695 'call':586,598 'categori':274 'channel':365 'cli':171,184,225,306,308,353,371,400,472,514,536 'cli.github.com':458 'cmd':195 'code':13,22,62,116,121,234,241,256,418,422,679 'code-search':240,255 'code.visualstudio.com':426 'command':226,446,474 'communiti':411 'complet':160 'concept':10,111 'condit':665 'config':163,566 'configur':114 'content':39,140,340 'context':670 'context7':34,291,391,420,451,482,569,573,588,600 'contribut':447 'copilot':469 'cosmos':636 'cover':53 'csharp':129 'daili':366 'davidpine.dev':369 'davidpine.dev/posts/aspire-docs-mcp-tools/':368 'db':637 'debug':438 'default':32,68 'depend':302 'deploy':402 'descript':324 'design':640 'detail':409,501,532 'dev':440 'devui':510,525,533,542,655 'direct':199 'directori':660 'discoveri':661 'dispatch':646 'doc':3,45,107,125,135,153,228,245,293,319,326,334,342,383,386,423,435,453,491,508,603,692 'docs.github.com':456 'document':7,56,102,330,346 'ecosystem':52 'edg':666 'effect':614 'endpoint':535,563 'enough':150 'etc':130 'everyth':76 'exampl':14,191 'except':266 'excerpt':147,168 'extens':442 'fall':388 'fastapi':653 'featur':437 'fetch':136,154,246,249 'find':9,119 'first':579 'flag':476,537 'follow':273 'framework':19,66,85,478,484,628,663 'full':138 'function':626,631 'g':216 'get':137,259,341,381 'gh':473 'github':23,63,449,452,471,495,643 'github.com':358 'github.com/dotnet/aspire/pull/14028)).':357 'global':211 'go':413 'guid':112,398,526,553 'handoff':668 'how-to':550 'id':393,430,460,520,578,592,608 'implement':408 'includ':315,618,669 'input':647 'instal':201,210,215 'instead':196,282 'integr':377,380,382,399,412,518,654 'intent':620,682 'intern':407 'java':414 'json':251,261 'kernel':87 'key':639 'languag':127,238,243,622,689 'learn':28,70,124,175,298,428,480,546 'learn.microsoft.com':43,54,78,110,277,488 'level':500,561 'lexic':336 'librari':392,429,459,519,577,591,607 'limit':686 'list':325,327,379 'live':41,58,275,294,424,454 'lookup':378 'm365':81 'major':99 'mapdevui':541 'matrix':648 'mcp':29,37,71,176,223,287,313,322,374,481,587,599 'microsoft':2,6,27,44,50,69,101,106,115,134,152,227,233,244,490 'microsoft-doc':1 'microsoft/learn-cli':204,217 'model':635 'mslearn':183,218,231,239,248 'name':596 'need':159,202 'net':17,80,283,517,539,674 'node.js':415 'npm':214 'npx':203 'offici':5 'often':504 'ollama':416 'one':581 'one-tim':580 'opentelemetri':659 'option':164,515 'orchestr':529 'output':262 'outsid':42,59,276 'overview':685 'page':139 'particular':509 'partit':638 'pass':126,250 'per':583 'platform':83 'point':448 'polyglot':691 'power':82 'powershel':193 'pr':355 'practic':642 'prefer':289 'primari':94,397 'process':265 'program':634 'provid':376 'proxi':565 'publish':507 'purpos':105 'python':128,632,652,693 'queri':4,103,230,237,544,574,602,612,615 'query-doc':601 'quickstart':683 'raw':260 'recommend':310 'ref':367 'refer':401,513,688 'relev':673 'remot':439 'repo':67,466,496,556 'research':46 'resolv':575,590 'resolve-library-id':589 'rest':511,534 'result':133 'retriev':343 'return':606 'run':198,213 'runtim':404 'sampl':117,235 'schema':564 'search':108,109,118,146,156,167,205,219,229,232,236,242,253,257,320,333,337,387,492 'secur':467 'self':364 'semant':86 'serv':656 'server':177,288,314,375 'session':584 'set':436 'setup':570 'shell':189 'ship':350 'skill':47 'skill-microsoft-docs' 'slug':348 'snippet':122 'sourc':405,548,557 'source-github' 'specif':143,345,562,611,617,629 'specifi':280 'strategi':649 'task':681 'technolog':51,595 'termin':187 'time':582 'tip':543 'token':568 'tool':74,95,104,224,271,281,301,321,323 'topic-agent-skills' 'topic-agents' 'topic-awesome' 'topic-custom-agents' 'topic-github-copilot' 'topic-hacktoberfest' 'topic-prompt-engineering' 'trace':527,658 'treeview':445 'truncat':170 'tutori':11,113,161,485,524,684 'typescript':694 'updat':361,363 'uploadasync':207,221 'url':144,247 'use':26,72,151,181,269,278,285,394,419,431,450,461,479,489,521 'user':434 'v2':633 'vast':98 'version':307,619,671 'vs':21,61,417,421,678 'websit':547 'webview':444 'weight':335 'window':88 'work':120 'workflow':528,645,664 'write':613","prices":[{"id":"a3420037-9b00-40e8-88d8-40d81e0d6485","listingId":"6002cbe6-38ca-432a-9b58-9101d8ce9b73","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"github","category":"awesome-copilot","install_from":"skills.sh"},"createdAt":"2026-04-18T20:25:12.428Z"}],"sources":[{"listingId":"6002cbe6-38ca-432a-9b58-9101d8ce9b73","source":"github","sourceId":"github/awesome-copilot/microsoft-docs","sourceUrl":"https://github.com/github/awesome-copilot/tree/main/skills/microsoft-docs","isPrimary":false,"firstSeenAt":"2026-04-18T21:50:13.547Z","lastSeenAt":"2026-05-18T18:52:17.138Z"},{"listingId":"6002cbe6-38ca-432a-9b58-9101d8ce9b73","source":"skills_sh","sourceId":"github/awesome-copilot/microsoft-docs","sourceUrl":"https://skills.sh/github/awesome-copilot/microsoft-docs","isPrimary":true,"firstSeenAt":"2026-04-18T20:25:12.428Z","lastSeenAt":"2026-05-07T22:40:16.826Z"}],"details":{"listingId":"6002cbe6-38ca-432a-9b58-9101d8ce9b73","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"github","slug":"microsoft-docs","github":{"repo":"github/awesome-copilot","stars":33270,"topics":["agent-skills","agents","ai","awesome","custom-agents","github-copilot","hacktoberfest","prompt-engineering"],"license":"mit","html_url":"https://github.com/github/awesome-copilot","pushed_at":"2026-05-18T01:26:59Z","description":"Community-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.","skill_md_sha":"bbfd424c631f402ab32dc4bfa584e31de39faae3","skill_md_path":"skills/microsoft-docs/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/github/awesome-copilot/tree/main/skills/microsoft-docs"},"layout":"multi","source":"github","category":"awesome-copilot","frontmatter":{"name":"microsoft-docs","description":"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."},"skills_sh_url":"https://skills.sh/github/awesome-copilot/microsoft-docs"},"updatedAt":"2026-05-18T18:52:17.138Z"}}