Awesome-omni-skill microsoft-docs

Consultar a documentação oficial da Microsoft para encontrar conceitos,

install
source · Clone the upstream repo
git clone https://github.com/diegosouzapw/awesome-omni-skill
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/development/microsoft-docs" ~/.claude/skills/diegosouzapw-awesome-omni-skill-microsoft-docs && rm -rf "$T"
manifest: skills/development/microsoft-docs/SKILL.md
source content

Microsoft Docs

Habilidade de pesquisa para o ecossistema de tecnologia da Microsoft. Abrange learn.microsoft.com e documentação que fica fora dele (repositórios do VS Code, GitHub, Aspire, Agent Framework).


Default: Microsoft Learn MCP

Use estas ferramentas para tudo no learn.microsoft.com — Azure, .NET, M365, Power Platform, Agent Framework, Semantic Kernel, Windows e mais. Esta é a ferramenta principal para a grande maioria das consultas sobre documentação da Microsoft.

ToolPurpose
microsoft_docs_search
Pesquisar learn.microsoft.com — conceitos, guias, tutoriais, configuração
microsoft_code_sample_search
Encontre trechos de código funcionais na documentação do Learn. Passe
language
(
python
,
csharp
, etc.) para melhores resultados
microsoft_docs_fetch
Obter o conteúdo completo da página de uma URL específica (quando os trechos de busca não são suficientes)

Use

microsoft_docs_fetch
após a busca quando precisar de tutoriais completos, todas as opções de configuração ou quando os trechos de busca estiverem truncados.


Exceptions: When to Use Other Tools

As seguintes categorias ficam fora do learn.microsoft.com. Use a ferramenta especificada em vez disso.

.NET Aspire — Use Aspire MCP Server (preferred) or Context7

A documentação do Aspire está em aspire.dev, não no Learn. A melhor ferramenta depende da sua versão do Aspire CLI:

CLI 13.2+ (recommended) — O servidor Aspire MCP inclui ferramentas de busca de documentação integradas:

MCP ToolDescription
list_docs
Lista toda a documentação disponível em aspire.dev
search_docs
Busca lexical ponderada no conteúdo do aspire.dev
get_doc
Recupera um documento específico pelo slug

Essas funcionalidades são entregues no Aspire CLI 13.2 (PR #14028). Para atualizar:

aspire update --self --channel daily
. Ref: https://davidpine.dev/posts/aspire-docs-mcp-tools/

CLI 13.1 — O servidor MCP fornece consulta de integrações (

list_integrations
,
get_integration_docs
) mas não busca na documentação. Recorrer ao Context7:

Library IDUse for
/microsoft/aspire.dev
Principal — guias, integrações, referência do CLI, implantação
/dotnet/aspire
Fonte de runtime — internos da API, detalhes de implementação
/communitytoolkit/aspire
Integrações da comunidade — Go, Java, Node.js, Ollama

VS Code — Use Context7

A documentação do VS Code está em code.visualstudio.com, não no Learn.

Library IDUse for
/websites/code_visualstudio
Documentação do usuário — configurações, recursos, depuração, desenvolvimento remoto
/websites/code_visualstudio_api
API de extensões — webviews, TreeViews, comandos, pontos de contribuição

GitHub — Use Context7

A documentação do GitHub está em docs.github.com e cli.github.com.

Library IDUse for
/websites/github_en
Actions, API, repositórios, segurança, administração, Copilot
/websites/cli_github
GitHub CLI (
gh
) — comandos e flags

Agent Framework — Use Learn MCP + Context7

Os tutoriais do Agent Framework estão em learn.microsoft.com (use

microsoft_docs_search
), mas o repositório do GitHub contém detalhes em nível de API que frequentemente estão à frente da documentação publicada — particularmente referência da API REST do DevUI, opções do CLI e integração com .NET.

Library IDUse for
/websites/learn_microsoft_en-us_agent-framework
Tutoriais — guias do DevUI, rastreamento, orquestração de fluxos de trabalho
/microsoft/agent-framework
Detalhes da API — endpoints REST do DevUI, flags do CLI, autenticação, .NET
AddDevUI
/
MapDevUI

DevUI tip: Consulte a origem do site Learn para guias de como-fazer, depois a origem do repositório para especificidades em nível de API (esquemas de endpoint, configuração de proxy, tokens de autenticação).


Context7 Setup

Para qualquer consulta ao Context7, resolva o ID da biblioteca primeiro (uma vez por sessão):

  1. Chame
    mcp_context7_resolve-library-id
    com o nome da tecnologia
  2. Chame
    mcp_context7_query-docs
    com o ID da biblioteca retornado e uma consulta específica

Writing Effective Queries

Seja específico — inclua versão, intenção e linguagem:

# ❌ Too broad
"Azure Functions"
"agent framework"

# ✅ Specific
"Azure Functions Python v2 programming model"
"Cosmos DB partition key design best practices"
"GitHub Actions workflow_dispatch inputs matrix strategy"
"Aspire AddUvicornApp Python FastAPI integration"
"DevUI serve agents tracing OpenTelemetry directory discovery"
"Agent Framework workflow conditional edges branching handoff"

Include context:

  • Version when relevant (
    .NET 8
    ,
    Aspire 13
    ,
    VS Code 1.96
    )
  • Task intent (
    quickstart
    ,
    tutorial
    ,
    overview
    ,
    limits
    ,
    API reference
    )
  • Language for polyglot docs (
    Python
    ,
    TypeScript
    ,
    C#
    )

<!-- CO-OP TRANSLATOR DISCLAIMER START -->

Isenção de responsabilidade:

Este documento foi traduzido usando o serviço de tradução por IA Co-op Translator (https://github.com/Azure/co-op-translator). Embora nos esforcemos pela precisão, esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original em seu idioma nativo deve ser considerado a fonte autoritativa. Para informações críticas, recomenda-se uma tradução humana profissional. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações equivocadas decorrentes do uso desta tradução.

<!-- CO-OP TRANSLATOR DISCLAIMER END -->