azure-deployment-preflight

Validate Azure Bicep deployments and generate a Markdown preflight report.

Updated May 16, 2026
One-click install
npx skills add https://github.com/p-o-ke-nae/pokemondamagecalculatorforstory --skill azure-deployment-preflight-p-o-ke-nae
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: azure-deployment-preflight
Source: https://github.com/p-o-ke-nae/pokemondamagecalculatorforstory/tree/main/.github/skills/azure-deployment-preflight
Command: npx skills add https://github.com/p-o-ke-nae/pokemondamagecalculatorforstory --skill azure-deployment-preflight-p-o-ke-nae

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill reduces deployment risk by checking Azure Bicep infrastructure changes before you run them, helping you catch syntax errors, permission gaps, and unintended resource changes early.

Core Features & Use Cases

  • Project Detection: Identifies whether a repository uses azd or standalone Bicep so it can choose the right validation flow.
  • Preflight Validation: Runs Bicep syntax checks and Azure what-if previews to reveal creates, updates, deletes, and skipped resources.
  • Permission Awareness: Detects RBAC limitations, retries with reduced validation when needed, and records actionable remediation steps.
  • Report Generation: Produces a structured preflight report that summarizes tools used, issues found, and next steps.
  • Use Case: Before deploying an app stack, use this Skill to review the infrastructure plan and confirm the deployment is safe to proceed.

Quick Start

Ask the assistant to validate the Azure deployment in this repository and generate a preflight report for the relevant Bicep files.

Frequently Asked Questions about azure-deployment-preflight

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

FAQPage Schema
How do I validate Azure Bicep deployments before execution?

To validate Azure Bicep deployments before execution, compile Bicep syntax and run Azure what-if previews to surface syntax errors, permission gaps, and unintended resource changes early. This preflight process generates a structured Markdown report summarizing issues and next steps.

Can I run a what-if analysis on standalone Bicep templates?

Yes, you can run a what-if analysis on standalone Bicep templates. The validation process detects whether your repository uses standalone Bicep or azd projects, applying appropriate preview validations across resource group, subscription, management group, and tenant deployment scenarios.

What is Bicep preflight validation and when do I need it?

Bicep preflight validation is the process of checking infrastructure changes before running them to reduce deployment risk. You need it before deploying an app stack to review the infrastructure plan and confirm the deployment is safe to proceed without unintended resource modifications.

Does Azure deployment validation detect RBAC permission issues?

Yes, Azure deployment validation detects RBAC permission issues during the what-if analysis. When it identifies RBAC limitations, it retries with reduced validation and records actionable remediation steps within the generated preflight report to help you resolve access gaps.

What are the limitations of Azure what-if previews for Bicep files?

A key limitation of Azure what-if previews is that RBAC permission gaps can restrict full validation results. When this happens, the process retries with reduced validation and logs the specific permission limitations and remediation steps needed to complete the preflight check.

How do I generate a preflight report for Azure infrastructure changes?

To generate a preflight report for Azure infrastructure changes, run Bicep syntax checks and what-if previews on your templates. The process produces a structured Markdown report that summarizes the tools used, issues found, and actionable next steps for your deployment.