playbooks

home / skills / github / awesome-copilot / microsoft-docs

microsoft-docs skill

/skills/microsoft-docs

This skill helps you locate and retrieve official Microsoft documentation across Azure, .NET, and 365 services for accurate, up-to-date guidance.

npx playbooks add skill github/awesome-copilot --skill microsoft-docs

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
2.1 KB
---
name: microsoft-docs
description: Query official Microsoft documentation to understand concepts, find tutorials, and learn how services work. Use for Azure, .NET, Microsoft 365, Windows, Power Platform, and all Microsoft technologies. Get accurate, current information from learn.microsoft.com and other official Microsoft websites—architecture overviews, quickstarts, configuration guides, limits, and best practices.
compatibility: Requires Microsoft Learn MCP Server (https://learn.microsoft.com/api/mcp)
---

# 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

Overview

This skill lets you query official Microsoft documentation to understand concepts, find tutorials, and learn how Microsoft services work. It pulls authoritative content from learn.microsoft.com and other Microsoft sites to provide architecture overviews, quickstarts, configuration guides, limits, and best practices. Use it to get current, accurate information about Azure, .NET, Microsoft 365, Windows, Power Platform, and related technologies.

How this skill works

The skill searches Microsoft Docs for relevant pages and returns concise excerpts or full-page content when needed. It uses targeted search queries to locate concept articles, tutorials, configuration references, and quota pages, then fetches full pages for step-by-step instructions or when excerpts are incomplete. Responses emphasize the exact document source, recommended pages to read, and actionable next steps.

When to use it

  • When you need an authoritative overview of a Microsoft technology or service
  • When you want quickstarts or step-by-step tutorials to set up a service
  • When you need configuration options, CLI commands, or API examples
  • When checking limits, quotas, or regional availability of services
  • When looking for official best practices and security guidance

Best practices

  • Make queries specific: include service, version, and intent (e.g., 'Azure Functions Python v2 quickstart')
  • Specify platform or framework when relevant (Linux, Windows, .NET version)
  • Request full-page fetch for tutorials or detailed configuration listings
  • Ask for limits/quotas by resource and region to get accurate numbers
  • Cross-check critical steps by asking for command snippets and exact config values

Example use cases

  • Find a Cosmos DB partition key design best-practices article and its examples
  • Retrieve an Azure Functions Python v2 quickstart with complete deployment steps
  • Get App Service configuration settings and the CLI commands to apply them
  • Check Azure OpenAI service rate limits and recommended retry strategies
  • Locate Container Apps scaling rules using KEDA and sample YAML manifests

FAQ

Can this return the full tutorial if the search excerpt is truncated?

Yes — when a tutorial or configuration guide is needed, the skill will fetch the full page so you get complete step-by-step content.

How current is the information returned?

The skill queries live Microsoft documentation, so responses reflect the current content on official Microsoft sites rather than static training data.