Agent Framework Azure AI Py
microsoft/skills
Build Azure AI Foundry agents using the Microsoft Agent Framework Python SDK (agent-framework-azure-ai).
查詢官方 Microsoft 文件，以尋找有關 Azure、.NET、Agent Framework、Aspire、VS Code、GitHub 等的概念、教學及程式碼範例。預設使用 Microsoft Learn MCP，對於存放在 learn.microsoft.com 以外的內容，則使用 Context7 與 Aspire MCP。
Install Microsoft Docs
$ npx skills add microsoft/ai-agents-for-beginners --skill microsoft-docs -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install microsoft/ai-agents-for-beginners microsoft-docs --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ 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-HK/.agents/skills/microsoft-docs .claude/skills/microsoft-docs && rm -rf skills-srcUse ~/.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/
Install the "microsoft-docs" agent skill from https://github.com/microsoft/ai-agents-for-beginners/tree/main/translations/zh-HK/.agents/skills/microsoft-docs into .claude/skills/microsoft-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "microsoft-docs", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/microsoft/ai-agents-for-beginners/tree/main/translations/zh-HK/.agents/skills/microsoft-docsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add microsoft/ai-agents-for-beginners --skill microsoft-docs -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install microsoft/ai-agents-for-beginners microsoft-docs --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/microsoft/ai-agents-for-beginners.git skills-src && mkdir -p .agents/skills && cp -r skills-src/translations/zh-HK/.agents/skills/microsoft-docs .agents/skills/microsoft-docs && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "microsoft-docs" agent skill from https://github.com/microsoft/ai-agents-for-beginners/tree/main/translations/zh-HK/.agents/skills/microsoft-docs into .agents/skills/microsoft-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "microsoft-docs", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add microsoft/ai-agents-for-beginners --skill microsoft-docs -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install microsoft/ai-agents-for-beginners microsoft-docs --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/microsoft/ai-agents-for-beginners.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/translations/zh-HK/.agents/skills/microsoft-docs .cursor/skills/microsoft-docs && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "microsoft-docs" agent skill from https://github.com/microsoft/ai-agents-for-beginners/tree/main/translations/zh-HK/.agents/skills/microsoft-docs into .cursor/skills/microsoft-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "microsoft-docs", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/microsoft/ai-agents-for-beginners.git --path translations/zh-HK/.agents/skills/microsoft-docs--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add microsoft/ai-agents-for-beginners --skill microsoft-docs -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install microsoft/ai-agents-for-beginners microsoft-docs --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/microsoft/ai-agents-for-beginners.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/translations/zh-HK/.agents/skills/microsoft-docs .gemini/skills/microsoft-docs && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "microsoft-docs" agent skill from https://github.com/microsoft/ai-agents-for-beginners/tree/main/translations/zh-HK/.agents/skills/microsoft-docs into .gemini/skills/microsoft-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "microsoft-docs", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install microsoft/ai-agents-for-beginners microsoft-docsInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add microsoft/ai-agents-for-beginners --skill microsoft-docs -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/microsoft/ai-agents-for-beginners.git skills-src && mkdir -p .github/skills && cp -r skills-src/translations/zh-HK/.agents/skills/microsoft-docs .github/skills/microsoft-docs && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "microsoft-docs" agent skill from https://github.com/microsoft/ai-agents-for-beginners/tree/main/translations/zh-HK/.agents/skills/microsoft-docs into .github/skills/microsoft-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "microsoft-docs", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add microsoft/ai-agents-for-beginners --skill microsoft-docs -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install microsoft/ai-agents-for-beginners microsoft-docs --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/microsoft/ai-agents-for-beginners.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/translations/zh-HK/.agents/skills/microsoft-docs .opencode/skills/microsoft-docs && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "microsoft-docs" agent skill from https://github.com/microsoft/ai-agents-for-beginners/tree/main/translations/zh-HK/.agents/skills/microsoft-docs into .opencode/skills/microsoft-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "microsoft-docs", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
microsoft-docs- GitHub stars
- 77k
- Token cost
- ~1.2k tokens
- SKILL.md length
- 428 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: Call mcp_context7_resolve-library-id… → Call mcp_context7_query-docs with the…
- 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 1.2k 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 .NET. 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.
- Call mcp_context7_resolve-library-id with the technology name
- Call mcp_context7_query-docs with the returned library ID and a specific query
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.comdavidpine.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 1.2k tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 428 words of instructions outside code blocks.
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). 428 words, ~1,198 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
Research skill for the Microsoft technology ecosystem. Covers learn.microsoft.com and documentation that lives outside it (VS Code, GitHub, Aspire, Agent Framework repos).
Default: Microsoft Learn MCP
Use these tools for learn.microsoft.com 上的所有內容 — Azure, .NET, M365, Power Platform, Agent Framework, Semantic Kernel, Windows, and more. This is the primary tool for the vast majority of Microsoft documentation queries.
| Tool | Purpose |
|---|---|
microsoft_docs_search | 在 learn.microsoft.com 搜尋 — 概念、指南、教學、設定 |
microsoft_code_sample_search | 從 Learn 文件中尋找可運行的程式碼片段。傳入 language（python、csharp 等）以獲得最佳結果 |
microsoft_docs_fetch | 從特定 URL 取得完整頁面內容（當搜尋摘錄不足時） |
Use microsoft_docs_fetch after search when you need complete tutorials, all config options, or when search excerpts are truncated.
Exceptions: When to Use Other Tools
The following categories live outside learn.microsoft.com. Use the specified tool instead.
.NET Aspire — Use Aspire MCP Server (preferred) or Context7
Aspire docs live on aspire.dev, not Learn. The best tool depends on your Aspire CLI version:
CLI 13.2+ (recommended) — The Aspire MCP server includes built-in docs search tools:
| MCP Tool | Description |
|---|---|
list_docs | Lists all available documentation from aspire.dev |
search_docs | Weighted lexical search across aspire.dev content |
get_doc | Retrieves a specific document by slug |
These ship in Aspire CLI 13.2 (PR #14028). To update: aspire update --self --channel daily. 參考: https://davidpine.dev/posts/aspire-docs-mcp-tools/
CLI 13.1 — The MCP server provides integration lookup (list_integrations, get_integration_docs) but not docs search. Fall back to Context7:
| Library ID | Use for |
|---|---|
/microsoft/aspire.dev | Primary — guides, integrations, CLI reference, deployment |
/dotnet/aspire | Runtime source — API internals, implementation details |
/communitytoolkit/aspire | Community integrations — Go, Java, Node.js, Ollama |
VS Code — Use Context7
VS Code docs live on code.visualstudio.com, not Learn.
| Library ID | Use for |
|---|---|
/websites/code_visualstudio | User docs — settings, features, debugging, remote dev |
/websites/code_visualstudio_api | Extension API — webviews, TreeViews, commands, contribution points |
Show full SKILL.md (172 more words)Show less
GitHub — Use Context7
GitHub docs live on docs.github.com and cli.github.com.
| Library ID | Use for |
|---|---|
/websites/github_en | Actions, API, repos, security, admin, Copilot |
/websites/cli_github | GitHub CLI (gh) commands and flags |
Agent Framework — Use Learn MCP + Context7
Agent Framework tutorials are on learn.microsoft.com (use microsoft_docs_search), but the GitHub repo has API-level detail that is often ahead of published docs — particularly DevUI REST API reference, CLI options, and .NET integration.
| Library ID | Use for |
|---|---|
/websites/learn_microsoft_en-us_agent-framework | Tutorials — DevUI guides, tracing, workflow orchestration |
/microsoft/agent-framework | API detail — DevUI REST endpoints, CLI flags, auth, .NET AddDevUI/MapDevUI |
DevUI 小貼士： 先查詢 Learn 網站來源以取得操作指南，然後查詢儲存庫來源以取得 API 級別的細節（端點 schema、代理設定、驗證令牌）。
Context7 Setup
For any Context7 query, resolve the library ID first (one-time per session):
- Call
mcp_context7_resolve-library-idwith the technology name - Call
mcp_context7_query-docswith the returned library ID and a specific query
Writing Effective Queries
Be specific — include version, intent, and language:
# ❌ 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:
- 版本（視情況而定）（
.NET 8,Aspire 13,VS Code 1.96） - 任務目的（
quickstart,tutorial,overview,limits,API reference） - 語言，針對多語言文件（
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-HK/.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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Microsoft Docs this skillmicrosoft/ai-agents-for-beginners | 77k | — | ~1.2k | Automated safety check: Pass | MIT | |
| Agent Framework Azure AI Pymicrosoft/skills | 3.1k | 1 repos | ~3.1k | Automated safety check: Pass | MIT | |
| Microsoft Skill CreatorMicrosoftDocs/mcp | 1.9k | 3 repos | ~2.1k | Automated safety check: Pass | CC-BY-4.0 | |
| Agent Frameworkjihadkhawaja/Egroo | 178 | — | ~1.9k | Automated safety check: Pass | Apache-2.0 | |
| Copilot SDKgithub/awesome-copilot | 40k | 5 repos | ~6.3k | Automated safety check: Pass | MIT | |
| Microsoft DocsMicrosoftDocs/mcp | 1.9k | 1 repos | ~723 | Automated safety check: Pass | CC-BY-4.0 |
Similar skills
- Official
- Official
Microsoft Skill Creator
MicrosoftDocs/mcp
Create agent skills for Microsoft technologies using official documentation.
Agent Framework
jihadkhawaja/Egroo
Build, extend, and debug AI agents in Egroo using the Microsoft Agent Framework (C .NET).
- Official
Copilot SDK
github/awesome-copilot
Build agentic applications with GitHub Copilot SDK. An agent skill from github/awesome-copilot.
- Official
Microsoft Docs
MicrosoftDocs/mcp
Understand Microsoft technologies by querying official documentation.
Setup Context A8c
woocommerce/woocommerce-ios
Set up the ContextA8C MCP server for accessing Automattic internal resources (Slack, Linear, P2s, GitHub Enterprise, etc.)
More from microsoft/ai-agents-for-beginners
All 123 skills in this repo- Official
Jupyter Notebook
microsoft/ai-agents-for-beginners
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…
- Official
Azure Openai To Responses
microsoft/ai-agents-for-beginners
Migrate Python apps from Azure OpenAI Chat Completions to the Responses API.
- Official
Azure Openai To Responses
microsoft/ai-agents-for-beginners
Shift Python apps dem from Azure OpenAI Chat Completions go Responses API.
- Official
Jupyter Notebook
microsoft/ai-agents-for-beginners
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…
- Official
Jupyter Notebook
microsoft/ai-agents-for-beginners
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…
- Official
Jupyter Notebook
microsoft/ai-agents-for-beginners
À 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…
Related
Categories
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-HK/.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-HK/.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 1.2k tokens (SKILL.md is roughly 4.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.