azure-well-architected-review
Perform an Azure Well-Architected Framework review of the current workload IaC and architecture, generating findings and GitHub issues for improvements.
Profile →npx skills add github/awesome-copilot --skill azure-well-architected-review --agent copilot
Same command for any agent — swap --agent for claude-code, codex, cursor.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Azure Well-Architected Review This workflow performs a structured Azure Well-Architected Framework (WAF) review against your workload's IaC files and deployed infrastructure. It identifies risks across all 5 WAF pillars and creates GitHub issues to track remediation. ## Prerequisites - Azure CLI (`az`) configured and authenticated - IaC files present in the repository (Bicep, Terraform, or ARM templates) - GitHub MCP server configured and authenticated ## Workflow Steps ### Step 1: Load Well-Architected Framework Reference Fetch current Azure WAF best practices: - `https://learn.microsoft.com/en-us/azure/well-architected/` - Service guides for the Azure services in use (`https://learn.microsoft.com/en-us/azure/well-architected/service-guides/`) - Workload-specific guidance relevant to the workload type (SaaS, mission-critical, AI, etc.) If the `microsoft.docs.mcp` MCP server is available, use it to query the latest pillar checklists and service-specific recommendations. ### Step 2: Discover IaC & Architecture Establish the review scope, then inventory both the code and the live environment: 1. **Confirm the Azure scope**: Ask the user which subscription(s)/resource group(s) are i
- Prerequisites
- Workflow Steps
- Step 1: Load Well-Architected Framework Reference
- Step 2: Discover IaC & Architecture
- Step 3: Pillar-by-Pillar Review
- Step 4: Risk Classification
- Step 5: User Confirmation
- Step 6: Create Individual Finding Issues
- Step 7: Create EPIC Tracking Issue
- Error Handling
- Success Criteria
What does the azure-well-architected-review skill do?
Perform an Azure Well-Architected Framework review of the current workload IaC and architecture, generating findings and GitHub issues for improvements.
How do I install it?
Run `npx skills add github/awesome-copilot --skill azure-well-architected-review --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From github/awesome-copilot, a repository with 37,432 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.