
Azure Validate
OfficialFreeEnsure your Azure deployments are ready and error-free.
Free · Opens the source repo
What Azure Validate does
Azure Validate is a pre-deployment validation tool designed specifically for Azure environments. It performs comprehensive checks on your configuration, infrastructure defined in Bicep or Terraform, RBAC role assignments, and managed identity permissions. By running these validations before deployment, developers can identify and resolve potential issues that could lead to deployment failures. This skill is particularly useful for teams looking to streamline their deployment process and ensure compliance with best practices.
The validation process is structured and requires the successful completion of a prerequisite step, azure-prepare, which ensures that a deployment plan is in place and approved. Following this, Azure Validate guides users through a series of validation steps, recording progress and results in a status file. This ensures that all necessary checks are completed before any deployment is attempted, thus reducing the risk of errors in production environments.
Azure Validate is intended for developers and DevOps engineers who are responsible for deploying applications in Azure. It is especially beneficial for teams that utilize Infrastructure as Code (IaC) practices with tools like Bicep and Terraform, as well as those who need to validate Azure Functions and serverless deployments. By incorporating this skill into their workflow, teams can enhance their deployment readiness and minimize troubleshooting time post-deployment.
While Azure Validate is a powerful tool for ensuring deployment readiness, it is important to note that it should not be used in isolation. It must be invoked after azure-prepare and before azure-deploy, as part of a complete deployment workflow. Additionally, it does not handle the deployment itself; that responsibility lies with the subsequent azure-deploy command, which must be explicitly invoked after successful validation.
When to use it
Use this skill when preparing to deploy applications to Azure and needing to validate configurations and permissions.
When not to use it
This skill is not suitable for deployments without prior validation steps or for environments outside of Azure.
What you can build with it
Validating Azure Functions Deployment
Before deploying an Azure Function, use Azure Validate to check that all function configurations and permissions are correctly set.
Pre-flight Checks for Infrastructure as Code
When using Bicep or Terraform, run Azure Validate to ensure your infrastructure is ready and compliant before deployment.
Troubleshooting Deployment Errors
If you encounter deployment errors, use Azure Validate to identify misconfigurations or permission issues that may be causing the failures.
How to install Azure Validate
View source1. Install with the skills CLI
npx skills add microsoft/azure-skills/azure-validate --agent claude-code2. Or install it manually
Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.
Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs
Inside SKILL.md
Written by microsoftAzure Validate
AUTHORITATIVE GUIDANCE — Follow these instructions exactly unless they contradict security policies given to you.
⛔ STOP — PREREQUISITE CHECK REQUIRED
Before proceeding, verify this prerequisite is met:
azure-prepare was invoked and completed →
.azure/deployment-plan.mdexists with statusApprovedor laterIf the plan is missing, STOP IMMEDIATELY and invoke azure-prepare first.
The complete workflow ensures success:
azure-prepare→azure-validate→azure-deploy
Triggers
- Check if app is ready to deploy
- Validate azure.yaml or Bicep
- Run preflight checks
- Troubleshoot deployment errors
Rules
- Run after azure-prepare, before azure-deploy
- All checks must pass—do not deploy with failures
- ⛔ Destructive actions require
ask_user— global-rules
Steps
Run the workflow script and follow its instructions. It walks you through each validation step one at a time, recording progress in .azure/validate-status.json. Use references/scripts/workflow.ps1 on Windows or references/scripts/workflow.sh on macOS/Linux.
Start by calling the script without the completed-step argument:
pwsh references/scripts/workflow.ps1 -WorkspacePath <workspace-path>
# macOS/Linux: bash references/scripts/workflow.sh --workspace-path <workspace-path>
Each run prints the next action and the value to pass next. Perform the action, then re-run with that value (-CompletedStep <value> for pwsh, --completed-step <value> for bash). Repeat until it reports the azure-validate workflow is complete.
The steps reference recipe details in references/recipes/README.md and role checks in references/role-verification.md.
⛔ VALIDATION AUTHORITY
This skill is the officially verified way to set plan status to
Validated. You MUST follow the script's instructions to completion before setting status toValidated. Do NOT set status toValidatedwithout doing so.
⚠️ NEXT STEP — DEPENDS ON USER INTENT
After ALL validations pass, check whether the user asked to deploy:
- If the user explicitly requested deployment, you MUST invoke azure-deploy to execute it. Do NOT run
azd up,azd deploy, or any deployment commands directly — let azure-deploy handle execution.- If the user only asked to validate or prepare (not deploy), STOP after recording proof and setting status to
Validated. Report the validation results and do NOT invoke azure-deploy.If any validation failed, fix the issues and re-run azure-validate before proceeding.
Frequently asked questions about Azure Validate
Similar skills
Turborepo
Optimized build system for JavaScript/TypeScript monorepos.
Azure Pipelines Validation
Streamline your Azure DevOps pipeline changes locally.
Azure Developer CLI
Streamline your Azure project workflows with best practices.
Azure Container Registry CLI
Manage Azure Container Registry resources with ease.
Aspire
Build and orchestrate polyglot distributed applications seamlessly.
Vercel CLI
Manage and deploy Vercel projects from the command line.
