Official agent skill

Microsoft Docs

by microsoft in microsoft/ai-agents-for-beginners

查詢官方 Microsoft 文件以尋找跨 Azure、.NET、Agent Framework、Aspire、VS Code、GitHub 等的概念、教學和程式碼範例。預設使用 Microsoft Learn MCP,對於存在於 learn.microsoft.com 以外的內容則使用 Context7 和 Aspire MCP。

OfficialMITAuto-check passedAI & LLM Engineering

Install Microsoft Docs

skills CLI
$ npx skills add microsoft/ai-agents-for-beginners --skill microsoft-docs -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install microsoft/ai-agents-for-beginners microsoft-docs --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/microsoft/ai-agents-for-beginners.git skills-src && mkdir -p .claude/skills && cp -r skills-src/translations/zh-TW/.agents/skills/microsoft-docs .claude/skills/microsoft-docs && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
microsoft-docs
GitHub stars
77k
Token cost
~962 tokens
SKILL.md length
257 words
Files
1
Skills in repo
123
Repo updated
First seen
Licence
MIT

At a glance

查詢官方 Microsoft 文件以尋找跨 Azure、.NET、Agent Framework、Aspire、VS Code、GitHub 等的概念、教學和程式碼範例。預設使用 Microsoft Learn MCP,對於存在於 learn.microsoft.com 以外的內容則使用 Context7 和 Aspire MCP。

  • Works in 2 steps: 呼叫 mcp_context7_resolve-library-id 並傳入技術名稱 → 使用回傳的 library ID 與具體查詢呼叫…
  • Tasks that involve Building AI agents
  • SKILL.md covers Default: Microsoft Learn MCP, Exceptions: When to Use Other…, Context7 Setup and Writing Effective Queries
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Microsoft Docs is an agent skill from microsoft/ai-agents-for-beginners, published by the product's own GitHub organization. 查詢官方 Microsoft 文件以尋找跨 Azure、.NET、Agent Framework、Aspire、VS Code、GitHub 等的概念、教學和程式碼範例。預設使用 Microsoft Learn MCP,對於存在於 learn.microsoft.com 以外的內容則使用 Context7 和 Aspire MCP。

Its SKILL.md is about 960 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering, covering Building AI agents and MCP servers. It works with Visual Studio Code, Model Context Protocol, Microsoft Azure and GitHub. The repository describes itself as: 18 Lessons to Get Started Building AI Agents. The licence is MIT.

When your agent uses it

  • Tasks that involve Building AI agents
  • Tasks that involve MCP servers

Example prompts

  • “/microsoft-docs”

Requirements

  • Python 3
  • Node.js

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. 呼叫 mcp_context7_resolve-library-id 並傳入技術名稱
  2. 使用回傳的 library ID 與具體查詢呼叫 mcp_context7_query-docs

What it can do on your machine

Read from SKILL.md and the folder at commit 25b7985. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com
    • davidpine.dev

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Microsoft Docs loads about 962 tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 257 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~46
When it runs · the whole SKILL.md, loaded when a task matches
~962

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from microsoft/ai-agents-for-beginners at commit 25b7985, republished under its MIT licence (© microsoft). 257 words, ~962 tokens.

Download SKILL.mdSave it as .claude/skills/microsoft-docs/SKILL.md (or your agent's skills folder).
name
microsoft-docs
description
查詢官方 Microsoft 文件以尋找跨 Azure、.NET、Agent Framework、Aspire、VS Code、GitHub 等的概念、教學和程式碼範例。預設使用 Microsoft Learn MCP,對於存在於 learn.microsoft.com 以外的內容則使用 Context7 和 Aspire MCP。

Microsoft Docs

研究 Microsoft 技術生態系的搜尋技能。涵蓋 learn.microsoft.com 以及存在於其外的文件(VS Code、GitHub、Aspire、Agent Framework 倉庫)。


Default: Microsoft Learn MCP

對於 learn.microsoft.com 上的所有內容請使用這些工具 —— Azure、.NET、M365、Power Platform、Agent Framework、Semantic Kernel、Windows 等等。這是絕大多數 Microsoft 文件查詢的主要工具。

ToolPurpose
microsoft_docs_search搜尋 learn.microsoft.com — 概念、指南、教學、設定
microsoft_code_sample_search從 Learn 文件中尋找可運行的程式碼片段。傳入 language(python、csharp 等)可獲得最佳結果
microsoft_docs_fetch從特定 URL 取得完整頁面內容(當搜尋摘錄不足時)

當您需要完整教學、所有設定選項,或搜尋摘錄被截斷時,請在搜尋後使用 microsoft_docs_fetch。


Exceptions: When to Use Other Tools

下列類別的內容位於 learn.microsoft.com 之外。請改用指定的工具。

.NET Aspire — 使用 Aspire MCP Server(首選)或 Context7

Aspire 文件位於 aspire.dev,而非 Learn。最佳工具取決於您的 Aspire CLI 版本:

CLI 13.2+(建議) — Aspire MCP 伺服器內建文件搜尋工具:

MCP ToolDescription
list_docs列出來自 aspire.dev 的所有可用文件
search_docs對 aspire.dev 內容進行加權詞彙搜尋
get_doc根據 slug 取得特定文件

這些功能隨 Aspire CLI 13.2 一併發布(PR #14028)。要更新:aspire update --self --channel daily。參考: https://davidpine.dev/posts/aspire-docs-mcp-tools/

CLI 13.1 — MCP 伺服器提供整合查詢(list_integrations, get_integration_docs)但不提供文件搜尋。請退回使用 Context7:

Library IDUse for
/microsoft/aspire.dev主要 — 指南、整合、CLI 參考、部署
/dotnet/aspire執行時原始碼 — API 內部、實作細節
/communitytoolkit/aspire社群整合 — Go、Java、Node.js、Ollama
VS Code — 使用 Context7

VS Code 文件位於 code.visualstudio.com,非 Learn。

Library IDUse for
/websites/code_visualstudio使用者文件 — 設定、功能、偵錯、遠端開發
/websites/code_visualstudio_api擴充功能 API — webviews、TreeViews、commands、contribution points
GitHub — 使用 Context7

GitHub 文件位於 docs.github.com 與 cli.github.com。

Library IDUse for
/websites/github_enActions、API、倉庫、資安、管理、Copilot
/websites/cli_githubGitHub CLI(gh)指令與參數
Agent Framework — 使用 Learn MCP + Context7

Agent Framework 教學在 learn.microsoft.com(使用 microsoft_docs_search),但 GitHub 倉庫 擁有經常領先已發布文件的 API 細節 — 尤其是 DevUI REST API 參考、CLI 選項,以及 .NET 的整合。

Library IDUse for
/websites/learn_microsoft_en-us_agent-framework教學 — DevUI 指南、追蹤、工作流程編排
/microsoft/agent-frameworkAPI 細節 — DevUI REST 端點、CLI 參數、認證、.NET AddDevUI/MapDevUI

DevUI 提示: 先查詢 Learn 網站的操作指南,然後查詢倉庫原始碼以取得 API 級別的細節(端點結構、代理設定、驗證權杖)。


Context7 Setup

對於任何 Context7 查詢,請先解析 library ID(每個工作階段一次性):

  1. 呼叫 mcp_context7_resolve-library-id 並傳入技術名稱
  2. 使用回傳的 library ID 與具體查詢呼叫 mcp_context7_query-docs

Writing Effective Queries

請具體 — 包含版本、目的與語言:

# ❌ 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 -->

免責聲明: 本文件係使用 AI 翻譯服務 Co-op Translator(https://github.com/Azure/co-op-translator)翻譯。雖然我們力求準確,但請注意自動翻譯可能包含錯誤或不準確之處。原始語言的文件應視為具權威性的來源。對於關鍵資訊,建議採用專業人工翻譯。我們不對因使用此翻譯而產生的任何誤解或曲解負責。

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

© microsoft, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in translations/zh-TW/.agents/skills/microsoft-docs of microsoft/ai-agents-for-beginners.

Open the folder on GitHubat commit 25b7985

Compare with similar skills

Microsoft Docs next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Microsoft Docs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Microsoft Docs this skillmicrosoft/ai-agents-for-beginners77k—~962Automated safety check: PassMIT
Agent Framework Azure AI Pymicrosoft/skills3.1k1 repos~3.1kAutomated safety check: PassMIT
Microsoft Skill CreatorMicrosoftDocs/mcp1.9k3 repos~2.1kAutomated safety check: PassCC-BY-4.0
Agent Frameworkjihadkhawaja/Egroo178—~1.9kAutomated safety check: PassApache-2.0
Copilot SDKgithub/awesome-copilot40k5 repos~6.3kAutomated safety check: PassMIT
Microsoft DocsMicrosoftDocs/mcp1.9k1 repos~723Automated safety check: PassCC-BY-4.0

Similar skills

  • Official

    Build Azure AI Foundry agents using the Microsoft Agent Framework Python SDK (agent-framework-azure-ai).

    3.1k GitHub starsUsed in 1 repo~3.1k tokens
    AI & LLM EngineeringAuto-check passed
  • Microsoft Skill Creator

    MicrosoftDocs/mcp

    Official

    Create agent skills for Microsoft technologies using official documentation.

    1.9k GitHub starsUsed in 3 repos~2.1k tokens
    Agent WorkflowsAuto-check passed
  • Agent Framework

    jihadkhawaja/Egroo

    Build, extend, and debug AI agents in Egroo using the Microsoft Agent Framework (C .NET).

    178 GitHub stars~1.9k tokensUpdated 6 mo ago
    AI & LLM EngineeringAuto-check passed
  • Copilot SDK

    github/awesome-copilot

    Official

    Build agentic applications with GitHub Copilot SDK. An agent skill from github/awesome-copilot.

    40k GitHub starsUsed in 5 repos~6.3k tokens
    AI & LLM EngineeringAuto-check passed
  • Microsoft Docs

    MicrosoftDocs/mcp

    Official

    Understand Microsoft technologies by querying official documentation.

    1.9k GitHub starsUsed in 1 repo~723 tokens
    Agent WorkflowsAuto-check passed
  • Setup Context A8c

    woocommerce/woocommerce-ios

    Set up the ContextA8C MCP server for accessing Automattic internal resources (Slack, Linear, P2s, GitHub Enterprise, etc.)

    358 GitHub starsUsed in 1 repo~627 tokens
    Agent WorkflowsAuto-check: notes

More from microsoft/ai-agents-for-beginners

All 123 skills in this repo
  • Jupyter Notebook

    microsoft/ai-agents-for-beginners

    Official

    A skill your agent uses when the user asks to create, scaffold, or edit Jupyter notebooks (.ipynb) for experiments, explorations, or tutorials; prefer the bundled templates and run the helper script…

    77k GitHub starsUsed in 8 repos~1k tokens
    Auto-check passed
  • Azure Openai To Responses

    microsoft/ai-agents-for-beginners

    Official

    Migrate Python apps from Azure OpenAI Chat Completions to the Responses API.

    77k GitHub stars~6k tokensUpdated 18 days ago
    Auto-check: notes
  • Azure Openai To Responses

    microsoft/ai-agents-for-beginners

    Official

    Shift Python apps dem from Azure OpenAI Chat Completions go Responses API.

    77k GitHub stars~6k tokensUpdated 18 days ago
    Auto-check: notes
  • Jupyter Notebook

    microsoft/ai-agents-for-beginners

    Official

    Kasuta, kui kasutaja palub luua, üles ehitada või redigeerida Jupyteri märkmikke (.ipynb) katsetuste, uurimiste või juhendite jaoks; eelista kaasasolevaid malle ja käivita abiskript newnotebook.py…

    77k GitHub stars~1.2k tokensUpdated 18 days ago
    Auto-check passed
  • Jupyter Notebook

    microsoft/ai-agents-for-beginners

    Official

    Käytetään, kun käyttäjä pyytää luomaan, alustamaan tai muokkaamaan Jupyter-muistikirjoja (.ipynb) kokeita, tutkimuksia tai opetusohjelmia varten; käytä mieluummin mukana olevia mallipohjia ja…

    77k GitHub stars~1.3k tokensUpdated 18 days ago
    Auto-check passed
  • Jupyter Notebook

    microsoft/ai-agents-for-beginners

    Official

    À utiliser lorsque l'utilisateur demande de créer, structurer ou modifier des notebooks Jupyter (.ipynb) pour des expériences, explorations ou tutoriels ; privilégiez les modèles fournis et exécutez…

    77k GitHub stars~1.4k tokensUpdated 18 days ago
    Auto-check passed

Questions about Microsoft Docs

What does Microsoft Docs do?

查詢官方 Microsoft 文件以尋找跨 Azure、.NET、Agent Framework、Aspire、VS Code、GitHub 等的概念、教學和程式碼範例。預設使用 Microsoft Learn MCP,對於存在於 learn.microsoft.com 以外的內容則使用 Context7 和 Aspire MCP。. Microsoft Docs is an agent skill from microsoft/ai-agents-for-beginners, published by the product's own GitHub organization.

When should I use Microsoft Docs?

Microsoft Docs fits situations like: tasks that involve Building AI agents; tasks that involve MCP servers.

How do I install Microsoft Docs in Claude Code?

Run `npx skills add microsoft/ai-agents-for-beginners --skill microsoft-docs -a claude-code`. Or copy the skill folder (translations/zh-TW/.agents/skills/microsoft-docs in microsoft/ai-agents-for-beginners) into .claude/skills/microsoft-docs in your project. Claude Code loads it when a task matches its description.

How do I install Microsoft Docs in Codex?

Run `npx skills add microsoft/ai-agents-for-beginners --skill microsoft-docs -a codex`. Or copy the skill folder (translations/zh-TW/.agents/skills/microsoft-docs in microsoft/ai-agents-for-beginners) into .agents/skills/microsoft-docs in your project. Codex loads it when a task matches its description.

Can I use Microsoft Docs in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add microsoft/ai-agents-for-beginners --skill microsoft-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/microsoft-docs, .gemini/skills/microsoft-docs, .github/skills/microsoft-docs and .opencode/skills/microsoft-docs in your project.

What does Microsoft Docs need to run?

SKILL.md names no scripts, command-line tools or credentials: Microsoft Docs is instructions for the agent only. Our summary lists: Python 3; Node.js.

Does Microsoft Docs access the network?

SKILL.md names 2 domains. As links in the text: github.com and davidpine.dev. This is read from the text; nothing was executed.

Is Microsoft Docs safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Microsoft Docs use?

Microsoft Docs is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Microsoft Docs use?

About 962 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Microsoft Docs?

Skills that share tags, products or a category with Microsoft Docs: Agent Framework Azure AI Py (microsoft/skills, 3.1k stars), Microsoft Skill Creator (MicrosoftDocs/mcp, 1.9k stars), Agent Framework (jihadkhawaja/Egroo, 178 stars) and Copilot SDK (github/awesome-copilot, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Microsoft Docs?

microsoft (a GitHub organization, an official publisher) maintains it in microsoft/ai-agents-for-beginners, which has 76,612 GitHub stars. The repository holds 123 skills in this directory. The repository was last updated on September 19, 2026.

Source: microsoft/ai-agents-for-beginners on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.