microsoft-docs

已同步 v1.1.0 授權: MIT 來源: microsoft/skills/.github/skills/microsoft-docs 提交: cde32f9 收錄的最新變更: 2026-03-31

Understand Microsoft technologies by querying official documentation. Use whenever the user asks how something works, wants tutorials, needs configuration options, limits, quotas, or best practices for any Microsoft technology (Azure, .NET, M365, Windows, Power Platform, etc.)—even if they don't mention "docs." If the question is about understanding a concept rather than writing code, this is the right skill.

摘要

用途: 透過官方 Microsoft 文件查找或擷取所需內容，以支援可靠的技術說明。
使用時機: 當需要研究 Microsoft 概念、學習指南、設定選項、服務限制或建議做法時使用。
輸出結果: 提供根據文件搜尋結果或擷取頁面整理的資訊；若 Learn MCP 伺服器無法使用，則可改用 mslearn CLI。

上游變更（1 筆，最新收錄 2026-03-31）

c80e398 2026-03-31 feat: add microsoft-docs skill for querying official Microsoft documentation 新增 Microsoft Docs 技能，可透過 MCP 搜尋及擷取官方文件，並以 mslearn CLI 作為替代方案。

npx skills add "lettucebo/Skills#v2.2.0@microsoft-docs" --full-depth

⚠ v2.2.0 發布後即可使用

Microsoft Docs

Tools

Tool	Use For
`microsoft_docs_search`	Find documentation—concepts, guides, tutorials, configuration
`microsoft_docs_fetch`	Get full page content (when search excerpts aren't enough)

When to Use

Understanding concepts — "How does Cosmos DB partitioning work?"
Learning a service — "Azure Functions overview", "Container Apps architecture"
Finding tutorials — "quickstart", "getting started", "step-by-step"
Configuration options — "App Service configuration settings"
Limits & quotas — "Azure OpenAI rate limits", "Service Bus quotas"
Best practices — "Azure security best practices"

Query Effectiveness

Good queries are specific:

# ❌ Too broad
"Azure Functions"

# ✅ Specific
"Azure Functions Python v2 programming model"
"Cosmos DB partition key design best practices"
"Container Apps scaling rules KEDA"

Include context:

Version when relevant (.NET 8, EF Core 8)
Task intent (quickstart, tutorial, overview, limits)
Platform for multi-platform docs (Linux, Windows)

When to Fetch Full Page

Fetch after search when:

Tutorials — need complete step-by-step instructions
Configuration guides — need all options listed
Deep dives — user wants comprehensive coverage
Search excerpt is cut off — full context needed

Why Use This

Accuracy — live docs, not training data that may be outdated
Completeness — tutorials have all steps, not fragments
Authority — official Microsoft documentation

CLI Alternative

If the Learn MCP server is not available, use the mslearn CLI from the command line instead:

# Run directly (no install needed)
npx @microsoft/learn-cli search "azure functions timeout"

# Or install globally, then run
npm install -g @microsoft/learn-cli
mslearn search "azure functions timeout"

MCP Tool	CLI Command
`microsoft_docs_search(query: "...")`	`mslearn search "..."`
`microsoft_docs_fetch(url: "...")`	`mslearn fetch "..."`

The fetch command also supports --section <heading> to extract a single section and --max-chars <number> to truncate output.