Official agent skill

Azure Architecture Autopilot

by github in github/awesome-copilot

Designs Azure infrastructure from a natural-language description, or diagrams an existing resource group, then refines the design through conversation and deploys it with Bicep.

OfficialMITAuto-check passedDevOps & Cloud

Install Azure Architecture Autopilot

skills CLI
$ npx skills add github/awesome-copilot --skill azure-architecture-autopilot -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install github/awesome-copilot azure-architecture-autopilot --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/github/awesome-copilot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/azure-architecture-autopilot .claude/skills/azure-architecture-autopilot && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
azure-architecture-autopilot
GitHub stars
40k
Used in
1 other repo
Token cost
~1.9k tokens
SKILL.md length
651 words
Files
18 (incl. scripts, references, assets)
Skills in repo
417
Repo updated
First seen
Licence
MIT

At a glance

Designs Azure infrastructure from a natural-language description, or diagrams an existing resource group, then refines the design through conversation and deploys it with Bicep.

  • Designing a new Azure architecture from a plain-language description
  • SKILL.md covers Automatic User Language…, Tool Usage Guide (GHCP…, External Tool Path Discovery and Progress Updates Required, plus 5 more sections
  • Runs Python scripts from its folder; calls az and pip
  • Generating a diagram of an existing Azure resource group

What it does

Can start from a request to create something new on Azure, or from an existing resource group to analyze and diagram, then take natural-language change requests such as reducing cost or strengthening security. Its diagram engine ships embedded as bundled Python scripts rather than a separate install, generating interactive HTML diagrams from more than 605 official Azure icons without network access.

The whole flow is organized as phases, each documented in its own reference file: a scanner phase for existing resources, an advisor phase, a Bicep generator and a Bicep reviewer, and a deployer phase. External tools such as the Azure CLI, Python and Bicep are located once per session and the discovered paths are cached rather than re-resolved on every step, and all user-facing progress updates and output are given in whichever language the user's first message was written in.

When your agent uses it

  • Designing a new Azure architecture from a plain-language description
  • Generating a diagram of an existing Azure resource group
  • Asking for a design change such as reducing cost or improving security
  • Generating and reviewing a Bicep template before deployment

Example prompts

  • “Set up a RAG architecture on Azure using AI Search and OpenAI.”
  • “Draw a diagram for rg-prod-eastus and suggest ways to reduce its cost.”
  • “Foundry is slow in this design — suggest and apply a fix.”

Requirements

  • Azure CLI (`az`)
  • Python
  • Bicep

What it can do on your machine

Read from SKILL.md and the folder at commit 7cce7cf. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • az
    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use az and pip, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Azure Architecture Autopilot loads about 1.9k tokens when it runs, and up to ~38k if it reads all its reference files. Until then it costs about 166 tokens; SKILL.md has 651 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~166
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~38k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from github/awesome-copilot at commit 7cce7cf, republished under its MIT licence (© github). 651 words, ~1,890 tokens.

Download SKILL.mdSave it as .claude/skills/azure-architecture-autopilot/SKILL.md (or your agent's skills folder). This skill also uses 17 other files; get the full folder from GitHub.
name
azure-architecture-autopilot
description
Design Azure infrastructure using natural language, or analyze existing Azure resources to auto-generate architecture diagrams, refine them through conversation, and deploy with Bicep. When to use this skill: - "Create X on Azure", "Set up a RAG architecture" (new design) - "Analyze my current Azure infrastructure", "Draw a diagram for rg-xxx" (existing analysis) - "Foundry is slow", "I want to reduce costs", "Strengthen security" (natural language modification) - Azure resource deployment, Bicep template generation, IaC code generation - Microsoft Foundry, AI Search, OpenAI, Fabric, ADLS Gen2, Databricks, and all Azure services

Azure Architecture Builder

A pipeline that designs Azure infrastructure using natural language, or analyzes existing resources to visualize architecture and proceed through modification and deployment.

The diagram engine is embedded within the skill (scripts/ folder). No pip install needed — it directly uses the bundled Python scripts to generate interactive HTML diagrams with 605+ official Azure icons. Ready to use immediately without network access or package installation.

Automatic User Language Detection

🚨 Detect the language of the user's first message and provide all subsequent responses in that language. This is the highest-priority principle.

  • If the user writes in Korean → respond in Korean
  • If the user writes in English → respond in English (ask_user, progress updates, reports, Bicep comments — all in English)
  • The instructions and examples in this document are written in English, and all user-facing output must match the user's language

⚠️ Do not copy examples from this document verbatim to the user. Use only the structure as reference, and adapt text to the user's language.

Tool Usage Guide (GHCP Environment)

FeatureTool NameNotes
Fetch URL contentweb_fetchFor MS Docs lookups, etc.
Web searchweb_searchURL discovery
Ask userask_userchoices must be a string array
Sub-agentstaskexplore/task/general-purpose
Shell command executionpowershellWindows PowerShell

All sub-agents (explore/task/general-purpose) cannot use web_fetch or web_search. Fact-checking that requires MS Docs lookups must be performed directly by the main agent.

External Tool Path Discovery

az, python, bicep, etc. are often not on PATH. Discover once before starting a Phase and cache the result. Do not re-discover every time.

⚠️ Do not use Get-Command python — risk of Windows Store alias. Direct filesystem discovery ($env:LOCALAPPDATA\Programs\Python) takes priority.

az CLI path:

powershell
$azCmd = $null
if (Get-Command az -ErrorAction SilentlyContinue) { $azCmd = 'az' }
if (-not $azCmd) {
  $azExe = Get-ChildItem -Path "$env:ProgramFiles\Microsoft SDKs\Azure\CLI2\wbin", "$env:LOCALAPPDATA\Programs\Azure CLI\wbin" -Filter "az.cmd" -ErrorAction SilentlyContinue | Select-Object -First 1 -ExpandProperty FullName
  if ($azExe) { $azCmd = $azExe }
}

Python path + embedded diagram engine: refer to the diagram generation section in references/phase1-advisor.md.

Progress Updates Required

Use blockquote + emoji + bold format:

markdown
> **⏳ [Action]** — [Reason]
> **✅ [Complete]** — [Result]
> **⚠️ [Warning]** — [Details]
> **❌ [Failed]** — [Cause]

Parallel Preload Principle

While waiting for user input via ask_user, preload information needed for the next step in parallel.

ask_user QuestionPreload Simultaneously
Project name / scan scopeReference files, MS Docs, Python path discovery, diagram module path verification
Model/SKU selectionMS Docs for next question choices
Architecture confirmationaz account show/list, az group list
Subscription selectionaz group list

Path Branching — Automatically Determined by User Request

Path A: New Design (New Build)

Trigger: "create", "set up", "deploy", "build", etc.

Phase 1 (references/phase1-advisor.md) — Interactive architecture design + diagram
    ↓
Phase 2 (references/bicep-generator.md) — Bicep code generation
    ↓
Phase 3 (references/bicep-reviewer.md) — Code review + compilation verification
    ↓
Phase 4 (references/phase4-deployer.md) — validate → what-if → deploy
Path B: Existing Analysis + Modification (Analyze & Modify)

Trigger: "analyze", "current resources", "scan", "draw a diagram", "show my infrastructure", etc.

Phase 0 (references/phase0-scanner.md) — Existing resource scan + diagram
    ↓
Modification conversation — "What would you like to change here?" (natural language modification request → follow-up questions)
    ↓
Phase 1 (references/phase1-advisor.md) — Confirm modifications + update diagram
    ↓
Phase 2~4 — Same as above
Show full SKILL.md (260 more words)Show less
When Path Determination Is Ambiguous

Ask the user directly:

ask_user({
  question: "What would you like to do?",
  choices: [
    "Design a new Azure architecture (Recommended)",
    "Analyze + modify existing Azure resources"
  ]
})

Phase Transition Rules

  • Each Phase reads and follows the instructions in its corresponding references/*.md file
  • When transitioning between Phases, always inform the user about the next step
  • Do not skip Phases (especially the what-if between Phase 3 → Phase 4)
  • 🚨 Required condition for Phase 1 → Phase 2 transition: 01_arch_diagram_draft.html must have been generated using the embedded diagram engine and shown to the user. Do not proceed to Bicep generation without a diagram. Completing spec collection alone does not mean Phase 1 is done — Phase 1 includes diagram generation + user confirmation.
  • Modification request after deployment → return to Phase 1, not Phase 0 (Delta Confirmation Rule)

Service Coverage & Fallback

Optimized Services

Microsoft Foundry, Azure OpenAI, AI Search, ADLS Gen2, Key Vault, Microsoft Fabric, Azure Data Factory, VNet/Private Endpoint, AML/AI Hub

Other Azure Services

All supported — MS Docs are automatically consulted to generate at the same quality standard. Do not send messages that cause user anxiety such as "out of scope" or "best-effort".

Stable vs Dynamic Information Handling
CategoryHandling MethodExamples
StableReference files firstisHnsEnabled: true, PE triple set
DynamicAlways fetch MS DocsAPI version, model availability, SKU, region

Quick Reference

FileRole
references/phase0-scanner.mdExisting resource scan + relationship inference + diagram
references/phase1-advisor.mdInteractive architecture design + fact checking
references/bicep-generator.mdBicep code generation rules
references/bicep-reviewer.mdCode review checklist
references/phase4-deployer.mdvalidate → what-if → deploy
references/service-gotchas.mdRequired properties, PE mappings
references/azure-dynamic-sources.mdMS Docs URL registry
references/azure-common-patterns.mdPE/security/naming patterns
references/ai-data.mdAI/Data service guide
assets/06-architecture-diagram.pngExample generated architecture diagram
assets/07-azure-portal-resources.pngExample Azure portal resource view
assets/08-deployment-succeeded.pngExample successful deployment result

© github, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 17 other files (scripts, references, assets) in skills/azure-architecture-autopilot of github/awesome-copilot.

  • SKILL.md
  • .gitignore
  • assets/06-architecture-diagram.png
  • assets/07-azure-portal-resources.png
  • assets/08-deployment-succeeded.png
  • references/ai-data.md
  • references/architecture-guidance-sources.md
  • references/azure-common-patterns.md
  • references/azure-dynamic-sources.md
  • references/bicep-generator.md
  • references/bicep-reviewer.md
  • references/phase0-scanner.md
  • references/phase1-advisor.md
  • references/phase4-deployer.md
  • references/service-gotchas.md
  • scripts/cli.py
  • scripts/generator.py
  • scripts/icons.py

Open the folder on GitHubat commit 7cce7cf

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in github/awesome-copilot, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Azure Architecture Autopilot next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Azure Architecture Autopilot compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Azure Architecture Autopilot this skillgithub/awesome-copilot40k1 repos~1.9kAutomated safety check: PassMIT
Azure Preparemicrosoft/GitHub-Copilot-for-Azure2551 repos~3.2kAutomated safety check: PassMIT
Azure Bicep Skilltimothywarner-org/claude-code224—~2.9kAutomated safety check: PassMIT
Apex Azure Bicep Patternsjonathan-vella/apex217—~2.5kAutomated safety check: PassMIT
Azv Diagram To BicepAzure/AZVerify101—~3.1kAutomated safety check: WarnMIT
Azure Data Science VmMicrosoftDocs/Agent-Skills777—~1.8kAutomated safety check: PassCC-BY-4.0

Similar skills

  • Azure Prepare

    microsoft/GitHub-Copilot-for-Azure

    Official

    Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Terraform), and Dockerfiles for the Azure Developer CLI (azd) workflow.

    255 GitHub starsUsed in 1 repo~3.2k tokens
    DevOps & CloudAuto-check passed
  • Azure Bicep Skill

    timothywarner-org/claude-code

    A skill your agent uses when authoring, reviewing, or refactoring Azure Bicep code.

    224 GitHub stars~2.9k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed
  • Apex Azure Bicep Patterns

    jonathan-vella/apex

    UTILITY SKILL — Reusable Azure Bicep patterns: hub-spoke, private endpoints, diagnostics, AVM composition.

    217 GitHub stars~2.5k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Azv Diagram To Bicep

    Azure/AZVerify

    Official

    Generate deployment-ready Bicep templates and PowerShell scripts from an approved Draw.io Azure architecture diagram.

    101 GitHub stars~3.1k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check: warnings
  • Azure Data Science Vm

    MicrosoftDocs/Agent-Skills

    Official

    Expert knowledge for Azure Data Science Virtual Machines development including troubleshooting, decision making, architecture & design patterns, security, configuration, integrations & coding…

    777 GitHub stars~1.8k tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed
  • Azure Diagrams

    cmb211087/azure-diagrams-skill

    Comprehensive technical diagramming toolkit for solutions architects, presales, and developers.

    150 GitHub stars~4k tokensUpdated 3 mo ago
    DevOps & CloudAuto-check: notes

More from github/awesome-copilot

All 417 skills in this repo
  • Acquire Codebase Knowledge

    github/awesome-copilot

    Official

    Maps an unfamiliar codebase into seven evidence-backed documents in docs/codebase/, using a scan script and templates, for onboarding or architecture write-ups.

    40k GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed
  • Draw.io Diagram Generator

    github/awesome-copilot

    Official

    Generates, edits and validates draw.io files with correct mxGraph XML, covering flowcharts, architecture, sequence, ER and UML class diagrams.

    40k GitHub starsUsed in 1 repo~4.9k tokens
    Auto-check passed
  • Credit Risk Data Cleaning

    github/awesome-copilot

    Official

    Cleans raw credit data and screens variables before loan modeling, dropping unstable, noisy or redundant features and writing an Excel report of every step.

    40k GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Daily Focus Board

    github/awesome-copilot

    Official

    Builds a warm, browser-based daily focus board the user updates by talking to their agent, with Eisenhower priorities, a brain-dump box and kind not-today carryover.

    40k GitHub stars~3k tokensUpdated today
    Auto-check passed
  • Python Pypi Package Builder

    github/awesome-copilot

    Official

    End-to-end skill for building, testing, linting, versioning, and publishing a production-grade Python library to PyPI.

    40k GitHub starsUsed in 1 repo~4.6k tokens
    Auto-check passed
  • Official

    Analyze Terraform plan JSON output for AzureRM Provider to distinguish between false-positive diffs (order-only changes in Set-type attributes) and actual resource changes.

    40k GitHub starsUsed in 1 repo~547 tokens
    Auto-check passed

Categories

Questions about Azure Architecture Autopilot

What does Azure Architecture Autopilot do?

Designs Azure infrastructure from a natural-language description, or diagrams an existing resource group, then refines the design through conversation and deploys it with Bicep. Can start from a request to create something new on Azure, or from an existing resource group to analyze and diagram, then take natural-language change requests such as reducing cost or strengthening security. Its diagram engine ships embedded as bundled Python scripts rather than a separate install, generating interactive HTML diagrams from more than 605 official Azure icons without network access.

When should I use Azure Architecture Autopilot?

Azure Architecture Autopilot fits situations like: designing a new Azure architecture from a plain-language description; generating a diagram of an existing Azure resource group; asking for a design change such as reducing cost or improving security; generating and reviewing a Bicep template before deployment.

How do I install Azure Architecture Autopilot in Claude Code?

Run `npx skills add github/awesome-copilot --skill azure-architecture-autopilot -a claude-code`. Or copy the skill folder (skills/azure-architecture-autopilot in github/awesome-copilot) into .claude/skills/azure-architecture-autopilot in your project. Claude Code loads it when a task matches its description.

How do I install Azure Architecture Autopilot in Codex?

Run `npx skills add github/awesome-copilot --skill azure-architecture-autopilot -a codex`. Or copy the skill folder (skills/azure-architecture-autopilot in github/awesome-copilot) into .agents/skills/azure-architecture-autopilot in your project. Codex loads it when a task matches its description.

Can I use Azure Architecture Autopilot in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add github/awesome-copilot --skill azure-architecture-autopilot -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/azure-architecture-autopilot, .gemini/skills/azure-architecture-autopilot, .github/skills/azure-architecture-autopilot and .opencode/skills/azure-architecture-autopilot in your project.

What does Azure Architecture Autopilot need to run?

Going by SKILL.md and its folder, Azure Architecture Autopilot needs Python for the scripts in its folder and the command-line tools its instructions call (az and pip). Our summary lists: Azure CLI (`az`); Python; Bicep.

Does Azure Architecture Autopilot access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Azure Architecture Autopilot safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Azure Architecture Autopilot use?

Azure Architecture Autopilot is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Azure Architecture Autopilot use?

About 1.9k tokens (SKILL.md is roughly 7.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 36k tokens, read only when the agent opens those files.

What are the alternatives to Azure Architecture Autopilot?

Skills that share tags, products or a category with Azure Architecture Autopilot: Azure Prepare (microsoft/GitHub-Copilot-for-Azure, 255 stars), Azure Bicep Skill (timothywarner-org/claude-code, 224 stars), Apex Azure Bicep Patterns (jonathan-vella/apex, 217 stars) and Azv Diagram To Bicep (Azure/AZVerify, 101 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Azure Architecture Autopilot?

github (a GitHub organization, an official publisher) maintains it in github/awesome-copilot, which has 39,792 GitHub stars. The repository holds 417 skills in this directory. The repository was last updated on October 8, 2026.

Source: github/awesome-copilot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.