| name | create-azure-agent |
| plugin | agent-scaffolders |
| description | Deploys a skill as an Azure AI Foundry hosted agent. NOT for Docker runtime skills (use `create-docker-skill`) and NOT for MCP server integrations (use `create-mcp-integration`).
|
| argument-hint | [skill-dir] |
| allowed-tools | Bash, Write, Read |
Follow the create-azure-agent skill workflow to generate Azure AI Foundry deployment
wrappers for an existing agent skill.
Inputs
$ARGUMENTS — optional path to the skill directory to deploy. Omit to start with discovery.
Steps
- If
$ARGUMENTS provides a skill directory, resolve and validate the path
- Follow the create-azure-agent phased workflow: confirm the target skill, gather Azure
configuration (subscription, resource group, region, naming preferences), then run
scaffold_azure_agent.py to generate Bicep templates and the Python Azure AI Projects
SDK deployment wrapper
- Summarize generated files in the skill's
azure_deployment/ directory
- Instruct on reviewing
.bicep parameters and running az deployment group create
Output
azure_deployment/azure_agent.py (Azure AI Projects SDK orchestration script) and
azure_deployment/main.bicep (Cosmos DB, AI Search, and Foundry Project infrastructure).
Edge Cases
- If
$ARGUMENTS is empty: ask for the target skill directory before proceeding
- If Azure credentials are not configured: instruct user to run
az login first
- Azure AI Foundry enforces a 128-tool limit — scaffold generates a focused worker agent
- Offer to run
/agent-scaffolders:audit-plugin to validate the skill before deploying
