Azure Blueprints

Organization

MicrosoftDocs

azure-blueprints

Expert knowledge for Azure Blueprints development including troubleshooting, decision making, security, configuration, integrations & coding patterns, and deployment. Use when migrating off Blueprints, mapping to PBMM/ISO/SWIFT, automating via CLI/PowerShell/REST, or fixing deployment errors, and other Azure Blueprints related development tasks. Not for Azure Policy (use azure-policy), Azure Resource Manager (use azure-resource-manager), Azure Resource Graph (use azure-resource-graph), Azure Portal (use azure-portal).

Overview

Publisher	MicrosoftDocs
Repository	`Agent-Skills`
Skill name	`azure-blueprints`
Stars	778
Forks	126
Bundled files	Instructions only
License	CC-BY-4.0
Links	Skill source Repository Homepage

Markdown instructions
A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.
Works with any LLM
AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.
Self-contained
Everything the model needs lives in the instructions — no extra files to sync.
Open source
Published by MicrosoftDocs on GitHub. Read the source before you install it.

Installation

Install the Azure Blueprints AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

Open the app and go to Plugins → Skills.
Choose "Install from GitHub".
Paste the skill folder URL below and confirm.
https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-blueprints
Enable the skill in any chat where you want it available.

Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills

git clone --depth 1 https://github.com/MicrosoftDocs/Agent-Skills.git /tmp/Agent-Skills
mkdir -p .claude/skills
cp -r /tmp/Agent-Skills/skills/azure-blueprints .claude/skills/azure-blueprints

Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Azure Blueprints in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Azure Blueprints on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Azure Blueprints is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

Loaded only when it is needed
The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.
Switch models mid-chat
Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

Azure Blueprints Skill

This skill provides expert guidance for Azure Blueprints. Covers troubleshooting, decision making, security, configuration, integrations & coding patterns, and deployment. 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

Category	Lines	Description
Troubleshooting	L34-L38	Diagnosing and fixing common Azure Blueprints deployment and assignment errors, including policy, role assignment, and resource lock issues, with step-by-step troubleshooting guidance.
Decision Making	L39-L44	Guidance on Azure Blueprints retirement timelines, planning and executing migrations, and answers to common questions about moving off Blueprints.
Security	L45-L60	Security-focused deployment stages, resource locks, operator roles, and using/mapping Azure Blueprints for compliance frameworks like PBMM, ISM PROTECTED, ISO 27001, SWIFT CSP, and UK OFFICIAL/NHS.
Configuration	L61-L72	Configuring and deploying Azure Blueprints (including security/ISO/CAF/SWIFT samples), using blueprint functions, and importing/exporting blueprints via PowerShell.
Integrations & Coding Patterns	L73-L79	Automating Azure Blueprints as code using CLI, PowerShell, and REST: create, import/export, and manage blueprint definitions and assignments programmatically.
Deployment	L80-L85	Controlling blueprint artifact deployment order, migrating blueprints to template specs/deployment stacks, and deploying the CAF Foundation blueprint with parameters.

Troubleshooting

Topic	URL
Troubleshoot common Azure Blueprints errors	https://learn.microsoft.com/en-us/azure/governance/blueprints/troubleshoot/general

Decision Making

Topic	URL
Plan migration off Azure Blueprints with timelines	https://learn.microsoft.com/en-us/azure/governance/blueprints/blueprint-retirement
Answer migration questions for Blueprints retirement	https://learn.microsoft.com/en-us/azure/governance/blueprints/blueprint-retirement-faq

Security

Topic	URL
Understand security-related stages of Azure Blueprint deployment	https://learn.microsoft.com/en-us/azure/governance/blueprints/concepts/deployment-stages
Configure resource locking behavior in Azure Blueprints	https://learn.microsoft.com/en-us/azure/governance/blueprints/concepts/resource-locking
Configure Azure Blueprint Operator role environment	https://learn.microsoft.com/en-us/azure/governance/blueprints/how-to/configure-for-blueprint-operator
Use Canada Federal PBMM blueprint for governance controls	https://learn.microsoft.com/en-us/azure/governance/blueprints/samples/canada-federal-pbmm
Use ISM PROTECTED blueprint for Australian compliance	https://learn.microsoft.com/en-us/azure/governance/blueprints/samples/ism-protected/
Map ISM PROTECTED controls to Azure Policy	https://learn.microsoft.com/en-us/azure/governance/blueprints/samples/ism-protected/control-mapping
Map ISO 27001 ASE/SQL controls to Policy and RBAC	https://learn.microsoft.com/en-us/azure/governance/blueprints/samples/iso27001-ase-sql-workload/control-mapping
Map ISO 27001 shared services controls to Azure Policy	https://learn.microsoft.com/en-us/azure/governance/blueprints/samples/iso27001-shared/control-mapping
Use SWIFT CSP-CSCF 2020 blueprint for Azure compliance	https://learn.microsoft.com/en-us/azure/governance/blueprints/samples/swift-2020/
Map SWIFT CSP-CSCF 2020 controls to Azure Policy	https://learn.microsoft.com/en-us/azure/governance/blueprints/samples/swift-2020/control-mapping
Use UK OFFICIAL and NHS blueprint for Azure governance	https://learn.microsoft.com/en-us/azure/governance/blueprints/samples/ukofficial-uknhs
Protect Azure Blueprint-deployed resources with locks	https://learn.microsoft.com/en-us/azure/governance/blueprints/tutorials/protect-new-resources

Configuration

Topic	URL
Import and export Azure Blueprints with PowerShell	https://learn.microsoft.com/en-us/azure/governance/blueprints/how-to/import-export-ps
Use Azure Blueprint functions in definitions and artifacts	https://learn.microsoft.com/en-us/azure/governance/blueprints/reference/blueprint-functions
Configure and deploy Azure Security Benchmark blueprint sample	https://learn.microsoft.com/en-us/azure/governance/blueprints/samples/azure-security-benchmark-foundation/deploy
Configure and deploy CAF migration landing zone blueprint	https://learn.microsoft.com/en-us/azure/governance/blueprints/samples/caf-migrate-landing-zone/deploy
Configure and deploy ISM PROTECTED blueprint sample	https://learn.microsoft.com/en-us/azure/governance/blueprints/samples/ism-protected/deploy
Configure and deploy ISO 27001 ASE/SQL workload blueprint	https://learn.microsoft.com/en-us/azure/governance/blueprints/samples/iso27001-ase-sql-workload/deploy
Configure and deploy ISO 27001 shared services blueprint	https://learn.microsoft.com/en-us/azure/governance/blueprints/samples/iso27001-shared/deploy
Configure and deploy SWIFT CSP-CSCF 2020 blueprint	https://learn.microsoft.com/en-us/azure/governance/blueprints/samples/swift-2020/deploy

Integrations & Coding Patterns

Topic	URL
Create Azure Blueprints using Azure CLI commands	https://learn.microsoft.com/en-us/azure/governance/blueprints/create-blueprint-azurecli
Create Azure Blueprints via REST API requests	https://learn.microsoft.com/en-us/azure/governance/blueprints/create-blueprint-rest-api
Manage Azure Blueprint assignments with Az.Blueprint PowerShell	https://learn.microsoft.com/en-us/azure/governance/blueprints/how-to/manage-assignments-ps

Deployment

Topic	URL
Control Azure Blueprint artifact deployment order	https://learn.microsoft.com/en-us/azure/governance/blueprints/concepts/sequencing-order
Migrate Azure Blueprints to template specs and deployment stacks	https://learn.microsoft.com/en-us/azure/governance/blueprints/migrate-to-template-specs
Deploy CAF Foundation blueprint with parameters	https://learn.microsoft.com/en-us/azure/governance/blueprints/samples/caf-foundation/deploy

Frequently asked questions

What does the Azure Blueprints AI skill do?

Why use Azure Blueprints on TypingMind?

Because you install it once and use it with any model. Azure Blueprints is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Azure Blueprints in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-blueprints. TypingMind reads its SKILL.md and installs it as a skill you can enable per chat.

Which AI models can use Azure Blueprints?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Azure Blueprints?

As many as you like. As long as a model supports skills, you can use Azure Blueprints with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Azure Blueprints AI skill free?

Yes. It is published on GitHub by MicrosoftDocs under the CC-BY-4.0 license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Setup Wizard Generator

NousResearch

OrganizationPopular

Generate a bash wizard guiding a human through manual setup.

Mcp Oauth Remote Gateway

NousResearch

OrganizationPopular

Manual OAuth for remote MCP servers on headless gateways.

Serving Llms Vllm

vLLM: high-throughput LLM serving, OpenAI API, quantization.

Modal

Serverless GPU cloud for ML jobs and model APIs.

Overview

Installation

Install in TypingMind

Install in another agent

Use it in TypingMind

Works with any AI model

Skill instructions

Azure Blueprints Skill

How to Use This Skill

Category Index

Troubleshooting

Decision Making

Security

Configuration

Integrations & Coding Patterns

Deployment

Frequently asked questions

Related AI Skills

Set up your own AI workspace now