Sponsor Suno AI Music arrow_forward
Skill

Hosted Agents V2 Py

Build hosted agents using Azure AI Projects SDK with ImageBasedHostedAgentDefinition. Use when creating container-based agents that run…

Type
Skill
Repository
microsoft/skills
GitHub stars
3.1k
License
MIT
Repo last updated
Sep 24, 2026
Source file
README.md

What Hosted Agents V2 Py is

Hosted Agents V2 Py is a skill published in the microsoft/skills repository on GitHub, which has about 3.1k stars. The repository describes itself as: “Skills, MCP servers, Custom Agents, Agents.md for SDKs to ground Coding Agents”

A skill is a folder with a SKILL.md file: frontmatter with a name and a description, followed by instructions Claude follows. Claude loads a skill automatically when a task matches its description, and you can also run it directly with a slash and its name.

Skills work in Claude Code and in Claude Cowork, which makes Hosted Agents V2 Py a portable way to give Claude the same method everywhere.

How to install Hosted Agents V2 Py

Claude Code

  1. Download the hosted-agents-v2-py folder from the repository.
  2. Save it as ~/.claude/skills/<skill-name>/SKILL.md for all projects, or .claude/skills/<skill-name>/SKILL.md for one project.
  3. Claude loads it automatically when a task matches; you can also run it with / and its name.

Claude Cowork

  1. Zip the skill folder so SKILL.md sits at the top level of the folder.
  2. Open Customize → Skills, click +, then upload the ZIP.
  3. Start a task that matches the description, or call it by name with /.

New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.

Inside the source file

An excerpt from README.md, shared under the repository's MIT license. Read the full file on GitHub.

> [!NOTE] > Work in Progress — This repository is under active development. More skills are being added, existing skills are being updated to use the latest SDK patterns, and tests are being expanded to ensure quality. Contributions welcome!

Skills, custom agents, AGENTS.md templates, and MCP configurations for AI coding agents working with Azure SDKs and Microsoft AI Foundry.

> Blog post: Context-Driven Development: Agent Skills for Microsoft Foundry and Azure

> 🔍 Skill Explorer: Browse all 175 skills with 1-click install

Quick Start

npx skills add microsoft/skills

Select the skills you need from the wizard. Skills are installed to your chosen agent's directory (e.g., .github/skills/ for GitHub Copilot) and symlinked if you use multiple agents.

Alternative installation methods

Manual installation (git clone)

# Clone and copy specific skills
git clone https://github.com/microsoft/skills.git
cp -r agent-skills/.github/skills/azure-cosmos-db-py your-project/.github/skills/

# Or use symlinks for multi-project setups
ln -s /path/to/agent-skills/.github/skills/mcp-builder /path/to/your-project/.github/skills/mcp-builder

# Share skills across different agent configs in the same repo
ln -s ../.github/skills .opencode/skills
ln -s ../.github/skills .claude/skills

Coding agents like Copilot CLI and GitHub Copilot in VS Code are powerful, but they lack domain knowledge about your SDKs. The patterns are already in their weights from pretraining. All you need is the right activation context to surface them.

> [!IMPORTANT] > Use skills selectively. Loading all skills causes context rot: diluted attention, wasted tokens, conflated patterns. Only copy skills essential for your current project.

What's Inside

Skill Catalog

> 175 skills across language plugins — see skill catalog below for the full breakdown

Core

> 11 skills — tooling, infrastructure, language-agnostic

Foundry (Language-Agnostic)

> 11 skills — Microsoft Foundry agent platform (preview), language-agnostic via azd, az CLI, and Foundry MCP

Python

> 39 skills • suffix: -py

Foundry & AI (5 skills)

M365 (1 skill)

AI Services (8 skills)

Data & Storage (7 skills)

Messaging & Events (4 skills)

Entra (2 skills)

Monitoring (4 skills)

Integration & Management (5 skills)

Patterns & Frameworks (3 skills)

.NET

> 29 skills • suffix: -dotnet

Foundry & AI (6 skills)

M365 (1 skill)

Data & Storage (6 skills)

Messaging (3 skills)

Entra (3 skills)

Compute & Integration (6 skills)

Monitoring & Partner (3 skills)

TypeScript

> 25 skills • suffix: -ts

Foundry & AI (6 skills)

M365 (1 skill)

Data & Storage (5 skills)

Messaging (3 skills)

Entra & Integration (4 skills)

Monitoring & Frontend (5 skills)

Infrastructure & Orchestration (1 skill)

Java

> 26 skills • suffix: -java

Foundry & AI (7 skills)

Communication (5 skills)

Data & Storage (3 skills)

Messaging (3 skills)

Entra (3 skills)

Monitoring & Integration (5 skills)

Rust

> 7 skills • suffix: -rust

Entra (4 skills)

Data & Storage (2 skills)

Messaging (1 skill)

Repository Structure

AGENTS.md                # Agent configuration template

.github/
├── skills/              # Backward-compat symlinks to plugin skills
├── plugins/             # Language-based plugin bundles (azure-sdk-python, etc.)
│   └── azure-sdk-*/     # Each bundle has skills/, commands/, agents/
├── prompts/             # Reusable prompt templates
├── agents/              # Agent persona definitions
├── scripts/             # Automation scripts (doc scraping)
├── workflows/           # GitHub Actions (daily doc updates)
└── copilot-instructions.md

docs/                    # Generated llms.txt files (daily workflow) - GitHub Pages hosted
├── llms.txt             # Links + summaries
└── llms-full.txt        # Full content

skills/                  # Symlinks for backward compatibility
├── python/              # -> ../.github/skills/*-py
…

Plugins

Plugins are installable packages containing curated sets of agents, commands, and skills. Install via the Copilot CLI:

Before you install

  • Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
  • Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
  • Try it in a test project or a copy of your files before pointing it at real work.
  • Pin the version you tested, and review changes before updating.
  • Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.

FAQ

What is Hosted Agents V2 Py?

Hosted Agents V2 Py is a skill for Claude Code and Claude Cowork from the microsoft/skills repository on GitHub. Build hosted agents using Azure AI Projects SDK with ImageBasedHostedAgentDefinition. Use when creating container-based agents that run…

How do I install Hosted Agents V2 Py in Claude Code?

Download the hosted-agents-v2-py folder from the repository. Save it as ~/.claude/skills/<skill-name>/SKILL.md for all projects, or .claude/skills/<skill-name>/SKILL.md for one project. Claude loads it automatically when a task matches; you can also run it with / and its name.

Can I use Hosted Agents V2 Py in Claude Cowork?

Zip the skill folder so SKILL.md sits at the top level of the folder. Open Customize → Skills, click +, then upload the ZIP. Start a task that matches the description, or call it by name with /.

Is Hosted Agents V2 Py safe to install?

It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.

Similar resources

Browse all skills, subagents, and plugins →

Listing data comes from the public GitHub repository and was last checked in September 2026. Excerpts are © their authors and shared under MIT. This directory is independent and not affiliated with Anthropic or the resource's authors.