Login
microsoftdocs/agent-skills1 file

Azure Well Architected

Expert guidance for designing, assessing, and optimizing Azure workloads using Azure Well Architected. Covers design review checklists, recommendations, design principles, tradeoffs, service guides, workload patterns, and assessment questions. Use when designing AI, HPC, SaaS, AVD, or mission-critical workloads and optimizing Azure services by WAF pillars, and other Azure Well Architected related development tasks.

Use this skillView repositoryView on skills.sh
Specification
Skill ID
microsoftdocs/agent-skills/azure-well-architected
Publisher
microsoftdocs
Repository
agent-skills
Installs
0
Files
1
Requires
Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
Synced
Sep 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

microsoftdocs/agent-skills/azure-well-architectedInstalls these files
  • SKILL.md

What this skill tells the agent

Azure Well Architected Skill

This skill provides expert guidance for designing, assessing, and optimizing Azure workloads using Azure Well Architected. Covers design review checklists, recommendations, design principles, tradeoffs, service guides, workload patterns, and assessment questions. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file
IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

  • Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
  • Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

CategoryLinesDescription
Design Review ChecklistsL35-L43Checklists to review Azure workloads for cost, operations, performance, reliability, and security best practices and identify gaps against Well-Architected guidance.
RecommendationsL44-L117Guidance on cost, reliability, performance, security, and operational excellence best practices for Azure workloads, including optimization, monitoring, automation, and sustainable cloud operations.
Design PrinciplesL118-L133High-level Azure design guidance: cost, performance, reliability, security/Zero Trust, sustainability, operational excellence, capacity resilience, and patterns for AI, HPC, and SaaS workloads.
TradeoffsL134-L143Guidance on weighing cost, reliability, performance, security, and operations tradeoffs in Azure architectures, including regions/AZ choices and cross-pillar design decisions.
Service GuidesL144-L179Service-specific Azure Well-Architected (WAF) guidance: design, configure, secure, and optimize individual services (compute, data, networking) using WAF pillars and best practices.
Workload PatternsL180-L224Design patterns, reference architectures, and end-to-end guidance for AI, HPC, mission-critical, SaaS, and sustainable workloads on Azure, including platforms, data, ops, security, and governance.
Assessment QuestionsL225-L236Guided assessments and maturity models to evaluate AI, SaaS, AVD, AVS, and other Azure workloads against WAF pillars: cost, reliability, security, performance, and operations.

Design Review Checklists

TopicURL
Use Cost Optimization design review checklist for Azurehttps://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/checklist
Use operational excellence design review checklisthttps://learn.microsoft.com/en-us/azure/well-architected/operational-excellence/checklist
Use performance efficiency design review checklisthttps://learn.microsoft.com/en-us/azure/well-architected/performance-efficiency/checklist
Use reliability design checklist for Azure workloadshttps://learn.microsoft.com/en-us/azure/well-architected/reliability/checklist
Use the Security design review checklist for workloadshttps://learn.microsoft.com/en-us/azure/well-architected/security/checklist

Recommendations

TopicURL
Align Azure resource usage with billing incrementshttps://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/align-usage-to-billing-increments
Implement cost data collection and review for Azure workloadshttps://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/collect-review-cost-data
Use consolidation strategies to reduce Azure costshttps://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/consolidation
Build and maintain a cost model for Azure workloadshttps://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/cost-model
Create a culture of financial responsibility for cloud costshttps://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/create-culture-financial-responsibility
Negotiate and obtain best provider rates for Azurehttps://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/get-best-rates
Reduce Azure workload costs through code optimizationhttps://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/optimize-code-costs
Optimize individual component costs in Azure workloadshttps://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/optimize-component-costs
Optimize Azure data storage and management costshttps://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/optimize-data-costs
Optimize non-production and production environment costshttps://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/optimize-environment-costs
Implement cost optimization for workload data flowshttps://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/optimize-flow-costs
Optimize personnel time for Azure workload operationshttps://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/optimize-personnel-time
Optimize scaling strategies to reduce Azure costshttps://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/optimize-scaling-costs
Implement spending guardrails for Azure cost optimizationhttps://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/set-spending-guardrails
Develop background jobs to offload application workloadshttps://learn.microsoft.com/en-us/azure/well-architected/design-guides/background-jobs
Create a disaster recovery plan for multi-region workloadshttps://learn.microsoft.com/en-us/azure/well-architected/design-guides/disaster-recovery
Implement transient fault handling in cloud applicationshttps://learn.microsoft.com/en-us/azure/well-architected/design-guides/handle-transient-faults
Build workload health models to improve reliabilityhttps://learn.microsoft.com/en-us/azure/well-architected/design-guides/health-modeling
Design and operate an incident management practicehttps://learn.microsoft.com/en-us/azure/well-architected/design-guides/incident-management
Design data partitioning for reliable Azure workloadshttps://learn.microsoft.com/en-us/azure/well-architected/design-guides/partition-data
Implement continuous integration for Azure release engineeringhttps://learn.microsoft.com/en-us/azure/well-architected/design-guides/release-engineering-continuous-integration
Design and implement automation in Azure workloadshttps://learn.microsoft.com/en-us/azure/well-architected/operational-excellence/enable-automation
Formalize development practices for Azure workloadshttps://learn.microsoft.com/en-us/azure/well-architected/operational-excellence/formalize-development-practices
Standardize Azure operations with formalized taskshttps://learn.microsoft.com/en-us/azure/well-architected/operational-excellence/formalize-operations-tasks
Design and run an incident management process for Azurehttps://learn.microsoft.com/en-us/azure/well-architected/operational-excellence/incident-response
Adopt infrastructure as code for Azure deploymentshttps://learn.microsoft.com/en-us/azure/well-architected/operational-excellence/infrastructure-as-code-design

More from microsoftdocs

microsoftdocs/agent-skills

Azure Container Apps

Expert knowledge for Azure Container Apps development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when configuring ACA ingress/scale, Dapr or Functions workloads, GitHub Actions CI/CD, private networking, or GPUs, and other Azure Container Apps related development tasks. Not for Azure App Service (use azure-app-service), Azure Functions (use azure-functions), Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure Spring Apps (use azure-spring-apps).

microsoftdocs/agent-skills

Azure SQL Database

Expert knowledge for Azure SQL Database development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when choosing tiers (DTU/vCore/serverless), configuring geo-replication/DR, Hyperscale, Data Sync, or elastic pools, and other Azure SQL Database related development tasks. Not for Azure SQL Managed Instance (use azure-sql-managed-instance), SQL Server on Azure Virtual Machines (use azure-sql-virtual-machines), Azure Cosmos DB (use azure-cosmos-db), Azure Data Factory (use azure-data-factory).

microsoftdocs/mcp

Microsoft Code Reference

Find working code samples, verify API signatures, and fix Microsoft SDK errors using official docs. Use whenever the user is writing, debugging, or reviewing code that touches any Microsoft SDK, .NET library, Azure client library, or Microsoft API—even if they don't ask for a "reference." Catches hallucinated methods, wrong signatures, and deprecated patterns. If the task involves producing or fixing Microsoft-related code, this is the right skill.

Use this skill in a project

Open any RiverX project, search the Skills panel for microsoftdocs/agent-skills/azure-well-architected, and install it in one click.

Use this skill