Agent Framework Azure AI Py
microsoft/skills
Build Azure AI Foundry agents using the Microsoft Agent Framework Python SDK (agent-framework-azure-ai).
Na to search official Microsoft documentation make you fit find concepts, tutorials, and code examples for Azure, .NET, Agent Framework, Aspire, VS Code, GitHub, and plenty more.
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/pcm/.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/pcm/.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/pcm/.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/pcm/.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/pcm/.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/pcm/.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/pcm/.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/pcm/.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/pcm/.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/pcm/.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/pcm/.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/pcm/.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/pcm/.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/pcm/.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.4k tokens
- SKILL.md length
- 564 words
- Files
- 1
- Skills in repo
- 123
- Repo updated
- First seen
- Licence
- MIT
At a glance
Na to search official Microsoft documentation make you fit find concepts, tutorials, and code examples for Azure, .NET, Agent Framework, Aspire, VS Code, GitHub, and plenty more.
- Works in 2 steps: Call mcp_context7_resolve-library-id… → Call mcp_context7_query-docs with di…
- Tasks that involve Building AI agents
- SKILL.md covers Di 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. Na to search official Microsoft documentation make you fit find concepts, tutorials, and code examples for Azure, .NET, Agent Framework, Aspire, VS Code, GitHub, and plenty more. E dey use Microsoft Learn MCP as the default, together with Context7 and Aspire MCP for content wey dey outside learn.microsoft.com.
Its SKILL.md is about 1.4k 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 di technology name
- Call mcp_context7_query-docs with di 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.4k tokens when it runs. Until then it costs about 82 tokens; SKILL.md has 564 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). 564 words, ~1,378 tokens.
Download SKILL.mdSave it as
.claude/skills/microsoft-docs/SKILL.md (or your agent's skills folder).- name
- microsoft-docs
- description
- Na to search official Microsoft documentation make you fit find concepts, tutorials, and code examples for Azure, .NET, Agent Framework, Aspire, VS Code, GitHub, and plenty more. E dey use Microsoft Learn MCP as the default, together with Context7 and Aspire MCP for content wey dey outside learn.microsoft.com.
Microsoft Docs
Skill wey you fit use to do research for the Microsoft technology ecosystem. E cover learn.microsoft.com and documentation wey dey outside am (VS Code, GitHub, Aspire, Agent Framework repos).
Di Default: Microsoft Learn MCP
Use these tools for everytin for learn.microsoft.com — Azure, .NET, M365, Power Platform, Agent Framework, Semantic Kernel, Windows, and more. Na dis one be di main tool for most Microsoft documentation questions.
| Tool | Wetin e dey do |
|---|---|
microsoft_docs_search | Search learn.microsoft.com — concepts, guides, tutorials, configuration |
microsoft_code_sample_search | Find working code snippets from Learn docs. Pass language (python, csharp, etc.) for best results |
microsoft_docs_fetch | Get full page content from a specific URL (when search excerpts aren't enough) |
Use microsoft_docs_fetch after search if you need full tutorials, all config options, or when search excerpts don cut.
Exceptions: When to Use Other Tools
Di categories wey follow dey live outside learn.microsoft.com. Use di tool wey dem specify instead.
.NET Aspire — Use Aspire MCP Server (wey better) or Context7
Aspire docs dey for aspire.dev, no for Learn. Di best tool depend on your Aspire CLI version:
CLI 13.2+ (wey recommended) — The Aspire MCP server get built-in docs search tools:
| MCP Tool | Wetin e dey do |
|---|---|
list_docs | List all di documentation wey dey for aspire.dev |
search_docs | Weighted lexical search across aspire.dev content |
get_doc | Retrieve specific document by slug |
Dem ship dis for Aspire CLI 13.2 (PR #14028). To update: aspire update --self --channel daily. Ref: https://davidpine.dev/posts/aspire-docs-mcp-tools/
CLI 13.1 — The MCP server provides integration lookup (list_integrations, get_integration_docs) but no 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 dey for code.visualstudio.com, no for 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 |
GitHub — Use Context7
GitHub docs dey for 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 |
Show full SKILL.md (234 more words)Show less
Agent Framework — Use Learn MCP + Context7
Agent Framework tutorials dey for learn.microsoft.com (use microsoft_docs_search), but di GitHub repo get API-level detail wey dey ahead of wetin dem publish — especially 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 tip: Query di Learn website source for how-to guides first, then check di repo source for API-level specifics (endpoint schemas, proxy config, auth tokens).
Context7 Setup
For any Context7 query, resolve the library ID first (one-time per session):
- Call
mcp_context7_resolve-library-idwith di technology name - Call
mcp_context7_query-docswith di returned library ID and a specific query
Writing Effective Queries
Make e 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:
- Version when e 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 -->Disclaimer: Dis dokument na AI translate — we take Co‑op Translator (https://github.com/Azure/co-op-translator). Even though we dey try make am correct, make you sabi say automated translations fit get mistakes or no 100% accurate. The original dokument for im original language na the correct/official source. If na important matter, make you use professional human translator. We no go responsible for any misunderstanding or wrong interpretation wey fit come from dis translation.
<!-- 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/pcm/.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.4k | 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?
Na to search official Microsoft documentation make you fit find concepts, tutorials, and code examples for Azure, .NET, Agent Framework, Aspire, VS Code, GitHub, and plenty more. Microsoft Docs is an agent skill from microsoft/ai-agents-for-beginners, published by the product's own GitHub organization.NET, Agent Framework, Aspire, VS Code, GitHub, and plenty more.
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/pcm/.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/pcm/.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.4k tokens (SKILL.md is roughly 5.5k 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,567 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.