azd-ai-init

Scaffold Azure AI Foundry agent projects with Bicep templates and azure.yaml.

1|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/spboyer/skill-azd-ai-init --skill azd-ai-init
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: azd-ai-init
Source: https://github.com/spboyer/skill-azd-ai-init/tree/main
Command: npx skills add https://github.com/spboyer/skill-azd-ai-init --skill azd-ai-init

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the scaffolding and setup of Azure AI Foundry hosted agent projects for the azd ai workflow, helping teams go from concept to deployable structure with minimal friction.

Core Features & Use Cases

  • Greenfield scaffolding: generate a complete azd ai project from scratch, including azure.yaml, infra/ with Bicep templates, Dockerfile, agent.yaml, and source structure.
  • Conversion & migration: adapt existing agent code to the azd ai hosting pattern for hosted deployment.
  • Deployment readiness: provide deployment guidance and validation steps to run using azd up and related commands.

Quick Start

Place in .github/skills/azd-ai-init/ in your repository, then invoke the skill with prompts such as "azd ai init" or "scaffold agent" to generate the required project scaffolding.

Frequently Asked Questions about azd-ai-init

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold an Azure AI Foundry hosted agent project?

You can scaffold an Azure AI Foundry hosted agent project by generating the required azure.yaml, infra/ Bicep templates, Dockerfile, and agent.yaml files. This skill automates the complete project structure generation for the azd ai workflow.

How do I migrate existing agent code to the azd ai hosting pattern?

To migrate existing agent code to the azd ai hosting pattern, this skill adapts your current agent structure to generate the required azure.yaml, Bicep infrastructure, and Dockerfile. It ensures your code conforms to the hosted deployment pattern for Azure AI Foundry.

What files are required for an azd ai workflow deployment?

The azd ai workflow requires an azure.yaml file, infra/ directory with Bicep templates, a Dockerfile, and an agent.yaml file. This skill enforces these required infrastructure patterns and validates the YAML before deployment.

Can I use Bicep templates for Azure AI Foundry infrastructure deployment?

Yes, you can use Bicep templates for Azure AI Foundry infrastructure deployment. This skill generates the necessary Bicep files inside the infra/ directory to enforce required infrastructure patterns and prepare the project for azd up deployment.

What is the best way to validate YAML before deploying an Azure AI Foundry agent?

The best way to validate YAML before deploying an Azure AI Foundry agent is to use this skill's built-in validation logic. It enforces required infrastructure patterns and validates the generated agent.yaml and related files to ensure deployment readiness.

How do I deploy an Azure AI Foundry agent using azd up?

To deploy an Azure AI Foundry agent using azd up, this skill provides deployment guidance and validation steps after generating the required project files. It ensures the Bicep templates and YAML configurations are valid and ready for the azd up command.