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, AVS, or mission‑critical workloads on Azure, and other Azure Well Architected related development tasks.
npx skills add MicrosoftDocs/Agent-Skills --skill azure-well-architected --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
What it does
A skill that provides expert guidance for designing, assessing, and optimizing Azure workloads using Azure Well Architected. It combines local quick-reference content with remote documentation fetching capabilities.
How it works
- Use the Category Index to locate relevant sections. For categories with line ranges, read specific lines via read_file with the specified lines. For categories with file links, read the linked reference file via read_file on the referenced file.
- It fetches documentation content from remote sources using network-enabled tools: preferred is mcp_microsoftdocs:microsoft_docs_fetch with query from=learn-agent-skill; fallback is fetch_webpage with query from=learn-agent-skill&accept=text/markdown.
- It includes sections such as Design Review Checklists, Recommendations, Design Principles, Tradeoffs, Service Guides, Workload Patterns, and Assessment Questions, each with associated guidance and resources.
When to use it
- Use when designing Azure workloads across AI, HPC, SaaS, AVD, AVS, or mission-critical scenarios, and other Azure Well Architected development tasks. (Trigger: category matches related topics; in practice, when you need guidance across Well Architected pillars.)
What it can touch
- It relies on tools and documentation sources: mcp_microsoftdocs:microsoft_docs_fetch and fetch_webpage to retrieve content.
- No explicit executable scripts or commands are listed beyond the read_file usage and the remote fetch tools.
Caveats
- Requires network access to fetch documentation content.
- Declares usage of mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage; these are necessary for operation. License is CC-BY-4.0 for the skill package.
# 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](https://github.com/MicrosoftDocs/mcp/blob/main/README.md) 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
- How to Use This Skill
- Category Index
- Design Review Checklists
- Recommendations
- Design Principles
- Tradeoffs
- Service Guides
- Workload Patterns
- Assessment Questions
What does the azure-well-architected skill do?
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, AVS, or mission‑critical workloads on Azure, and other Azure Well Architected related development tasks.
How do I install it?
Run `npx skills add MicrosoftDocs/Agent-Skills --skill azure-well-architected --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 MicrosoftDocs/Agent-Skills, a repository with 682 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.
