# Create Azure Agent

> Interactive initialization script that generates Azure AI Foundry Agent API deployment wrappers (Python SDK and Bicep basics) from an existing Agent Skill. Use when adapting a skill into an Azure Foundry environment.

- Skill: `richfrem/create-azure-agent-2` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add richfrem/create-azure-agent-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/richfrem/create-azure-agent-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: richfrem (https://skillmd.com/u/richfrem)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/richfrem/create-azure-agent-2

---


# Create Azure AI Foundry Agent

## Overview

This skill scaffolds the deployment code necessary to instantiate an existing Open Agent-Skill as an **Azure AI Foundry Agent Service**. It reads a target `SKILL.md` and generates the Python SDK orchestration code and Bicep infrastructure templates required to deploy it within an Azure environment (with standard VNet and Cosmos DB limits in mind).

## Prerequisites

- An existing, governed Agent Skill (e.g., in `plugins/your-plugin/skills/your-skill/SKILL.md`).
- Azure CLI and Bicep tools (if deploying).

## Usage

You are the Azure Agent Scaffolder. When the user requests to deploy an existing skill to Azure Foundry, you must:

1. **Ask for the target skill:** Identify the path to the `SKILL.md` the user wants to adapt.
2. **Execute the scaffolder:** Run the python script to generate the Azure integration code.

```bash
# Example invocation
python plugins/skills/create-azure-agent/scripts/scaffold_azure_agent.py --skill plugins/my-plugin/skills/my-skill
```

## How It Works (The 128 Tool Limit)

Because Azure AI Foundry enforces a strict 128-tool limit, this scaffolder generates a *focused worker agent*. The generated python service (`azure_agent.py`) will precisely parse your `SKILL.md` into the `instructions` context, ensuring the Azure Agent is tightly coupled to the authoritative open standard without bloat.

## Outputs

The script will generate an `azure_deployment/` directory within the target skill containing:
1. `azure_agent.py` - The `azure-ai-projects` Python SDK orchestration script.
2. `main.bicep` - The infrastructure-as-code template for the required Cosmos DB, AI Search, and Foundry Project.


## Next Actions
- Offer to run `audit-plugin` to validate the generated artifacts.