New to Claude Skills? Learn how to install them →

microsoft on GitHub

Azure Validate

OfficialFree

Ensure your Azure deployments are ready and error-free.

by microsoft1.4k stars on microsoft/azure-skills
3 views
Updated Aug 10, 2026
Get this skill

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 source

1. Install with the skills CLI

npx skills add microsoft/azure-skills/azure-validate --agent claude-code

2. 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 microsoft

Azure 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.md exists with status Approved or later

If the plan is missing, STOP IMMEDIATELY and invoke azure-prepare first.

The complete workflow ensures success:

azure-prepareazure-validateazure-deploy

Triggers

  • Check if app is ready to deploy
  • Validate azure.yaml or Bicep
  • Run preflight checks
  • Troubleshoot deployment errors

Rules

  1. Run after azure-prepare, before azure-deploy
  2. All checks must pass—do not deploy with failures
  3. Destructive actions require ask_userglobal-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 to Validated. Do NOT set status to Validated without 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