microsoft-docs
Scannednpx machina-cli add skill MicrosoftDocs/mcp/microsoft-docs --openclawFiles (1)
SKILL.md
2.1 KB
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
Source
git clone https://github.com/MicrosoftDocs/mcp/blob/main/skills/microsoft-docs/SKILL.mdView on GitHub Overview
The microsoft-docs skill helps you locate and consume official Microsoft Learn and learn.microsoft.com content across Azure, .NET, Microsoft 365, Windows, Power Platform, and more. It emphasizes accuracy and completeness by surfacing architecture overviews, quickstarts, configuration guides, limits, and best practices from authoritative sources.
How This Skill Works
The skill uses two tools: microsoft_docs_search to locate relevant docs and microsoft_docs_fetch to retrieve full pages when excerpts aren’t enough. You can specify version, task intent, and platform to surface targeted, up-to-date guidance from official Microsoft resources (learn.microsoft.com, etc.).
When to Use It
- Understanding concepts like how Cosmos DB partitioning works in official docs
- Learning a service with an overview or architecture guide (e.g., Azure Functions overview, Container Apps architecture)
- Finding tutorials such as quickstarts or step-by-step getting started guides
- Exploring configuration options and settings (e.g., App Service configuration settings)
- Checking limits and best practices (e.g., Azure OpenAI quotas, Azure security best practices)
Quick Start
- Step 1: Use microsoft_docs_search to locate the relevant concept or tutorial
- Step 2: Use microsoft_docs_fetch to pull the full page content when needed
- Step 3: Read the guide and extract key actions, limits, and best practices
Best Practices
- Write precise, context-rich queries including version and platform
- Prefer quickstart or tutorial intent when you need step-by-step instructions
- Fetch full pages for complete tutorials and configuration guides
- Cross-check facts against the official docs for the latest updates
- Leverage 'limits' and 'best practices' sections to plan deployments
Example Use Cases
- Find Cosmos DB partition key design best practices
- Review Azure Functions overview to understand service capabilities
- Browse App Service configuration settings for deployment tuning
- Study Container Apps architecture to design scalable microservices
- Check Azure OpenAI rate limits and quotas for a new integration
Frequently Asked Questions
Add this skill to your agents
