{"id":"6002cbe6-38ca-432a-9b58-9101d8ce9b73","shortId":"TQy2EZ","kind":"skill","title":"Microsoft Docs","tagline":"Awesome Copilot skill by Github","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"],"capabilities":["skill","source-github","category-awesome-copilot"],"categories":["awesome-copilot"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/github/awesome-copilot/microsoft-docs","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"install_from":"skills.sh"}},"qualityScore":"0.300","qualityRationale":"deterministic score 0.30 from registry signals: · indexed on skills.sh · published under github/awesome-copilot","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:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T19:40:26.597Z","embedding":null,"createdAt":"2026-04-18T20:25:12.428Z","updatedAt":"2026-04-22T19:40:26.597Z","lastSeenAt":"2026-04-22T19:40:26.597Z","tsv":"'/communitytoolkit/aspire':374 '/dotnet/aspire':367 '/dotnet/aspire/pull/14028)).':323 '/microsoft/agent-framework':494 '/microsoft/aspire.dev':360 '/posts/aspire-docs-mcp-tools/':334 '/websites/cli_github':434 '/websites/code_visualstudio':397 '/websites/code_visualstudio_api':405 '/websites/github_en':427 '/websites/learn_microsoft_en-us_agent-framework':487 '1':549 '1.96':644 '13':641 '13.1':336 '13.2':273,318 '14028':320 '2':561 '8':639 'across':302 'action':428,608 'adddevui':504 'adduvicornapp':615 'admin':432 'agent':29,48,441,447,591,621,626 'ahead':469 'altern':136 'api':370,407,429,463,476,495,524,651 'api-level':462,523 'aren':112 'aspir':28,248,250,256,269,276,316,326,614,640 'aspire.dev':260,296,303 'auth':502,531 'avail':144,293 'awesom':3 'azur':43,589,594 'azure.storage.blobs':172,186 'back':353 'bash':156,161 'best':96,264,605 'blobclient':170,184 'branch':631 'broad':588 'built':281 'built-in':280 'c':659 'call':550,562 'categori':238 'category-awesome-copilot' 'channel':329 'cli':135,148,189,270,272,317,335,364,436,478,500 'cli.github.com':422 'cmd':159 'code':26,80,85,198,205,220,382,386,643 'code-search':204,219 'code.visualstudio.com':390 'command':190,410,438 'communiti':375 'complet':124 'concept':75 'condit':629 'config':127,530 'configur':78 'content':104,304 'context':634 'context7':255,355,384,415,446,533,537,552,564 'contribut':411 'copilot':4,433 'cosmos':600 'cover':17 'csharp':93 'daili':330 'davidpine.dev':333 'davidpine.dev/posts/aspire-docs-mcp-tools/':332 'db':601 'debug':402 'default':32 'depend':266 'deploy':366 'descript':288 'design':604 'detail':373,465,496 'dev':404 'devui':474,489,497,506,619 'direct':163 'directori':624 'discoveri':625 'dispatch':610 'doc':2,9,71,89,99,117,192,209,257,283,290,298,306,347,350,387,399,417,455,472,567,656 'docs.github.com':420 'document':20,66,294,310 'ecosystem':16 'edg':630 'effect':578 'endpoint':499,527 'enough':114 'etc':94 'everyth':40 'exampl':155 'except':230 'excerpt':111,132 'extens':406 'fall':352 'fastapi':617 'featur':401 'fetch':100,118,210,213 'find':83 'first':543 'flag':440,501 'follow':237 'framework':30,49,442,448,592,627 'full':102 'function':590,595 'g':180 'get':101,223,305,345 'gh':437 'github':7,27,413,416,435,459,607 'github.com':322 'github.com/dotnet/aspire/pull/14028)).':321 'global':175 'go':377 'guid':76,362,490,517 'handoff':632 'how-to':514 'id':357,394,424,484,542,556,572 'implement':372 'includ':279,582,633 'input':611 'instal':165,174,179 'instead':160,246 'integr':341,344,346,363,376,482,618 'intent':584,646 'intern':371 'java':378 'json':215,225 'kernel':51 'key':603 'languag':91,202,207,586,653 'learn':34,88,139,262,392,444,510 'learn.microsoft.com':18,42,74,241,452 'level':464,525 'lexic':300 'librari':356,393,423,483,541,555,571 'limit':650 'list':289,291,343 'live':22,239,258,388,418 'lookup':342 'm365':45 'major':63 'mapdevui':505 'matrix':612 'mcp':35,140,187,251,277,286,338,445,551,563 'microsoft':1,8,14,33,65,70,79,98,116,191,197,208,454 'microsoft/learn-cli':168,181 'model':599 'mslearn':147,182,195,203,212 'name':560 'need':123,166 'net':44,247,481,503,638 'node.js':379 'npm':178 'npx':167 'often':468 'ollama':380 'one':545 'one-tim':544 'opentelemetri':623 'option':128,479 'orchestr':493 'output':226 'outsid':23,240 'overview':649 'page':103 'particular':473 'partit':602 'pass':90,214 'per':547 'platform':47 'point':412 'polyglot':655 'power':46 'powershel':157 'pr':319 'practic':606 'prefer':253 'primari':58,361 'process':229 'program':598 'provid':340 'proxi':529 'publish':471 'purpos':69 'python':92,596,616,657 'queri':67,194,201,508,538,566,576,579 'query-doc':565 'quickstart':647 'raw':224 'recommend':274 'ref':331 'refer':365,477,652 'relev':637 'remot':403 'repo':31,430,460,520 'research':10 'resolv':539,554 'resolve-library-id':553 'rest':475,498 'result':97 'retriev':307 'return':570 'run':162,177 'runtim':368 'sampl':81,199 'schema':528 'search':72,73,82,110,120,131,169,183,193,196,200,206,217,221,284,297,301,351,456 'secur':431 'self':328 'semant':50 'serv':620 'server':141,252,278,339 'session':548 'set':400 'setup':534 'shell':153 'ship':314 'skill':5,11 'slug':312 'snippet':86 'sourc':369,512,521 'source-github' 'specif':107,309,526,575,581,593 'specifi':244 'strategi':613 'task':645 'technolog':15,559 'termin':151 'time':546 'tip':507 'token':532 'tool':38,59,68,188,235,245,265,285,287 'trace':491,622 'treeview':409 'truncat':134 'tutori':77,125,449,488,648 'typescript':658 'updat':325,327 'uploadasync':171,185 'url':108,211 'use':36,115,145,233,242,249,358,383,395,414,425,443,453,485 'user':398 'v2':597 'vast':62 'version':271,583,635 'vs':25,381,385,642 'websit':511 'webview':408 'weight':299 'window':52 'work':84 'workflow':492,609,628 'write':577","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-04-22T18:52:59.779Z"},{"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-04-22T19:40:26.597Z"}],"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","source":"skills_sh","category":"awesome-copilot","skills_sh_url":"https://skills.sh/github/awesome-copilot/microsoft-docs"},"updatedAt":"2026-04-22T19:40:26.597Z"}}