azure-policy
Expert knowledge for Azure Policy development including troubleshooting, best practices, decision making, architecture & design patterns, security, configuration, integrations & coding patterns, and deployment. Use when authoring policy JSON, deploying via ARM/Bicep/Terraform, enforcing baselines, automating with DevOps, or using Machine Configuration, and other Azure Policy related development tasks. Not for Azure Blueprints (use azure-blueprints), Azure Resource Manager (use azure-resource-manager), Azure Role-based access control (use azure-rbac), Azure Security (use azure-security).
npx skills add MicrosoftDocs/Agent-Skills --skill azure-policy --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
Provides expert guidance for Azure Policy across troubleshooting, best practices, decision making, architecture & design patterns, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.
How it works
- Use Category Index to locate relevant sections. For categories with line ranges, read specific lines using read_file with the given range. For categories with file links, read the linked reference file with read_file on that reference.
- If metadata.generated_at is over 3 months old, suggest pulling the latest version from the repository. If mcp_microsoftdocs tools are unavailable, suggest installing them via the provided Installation Guide link.
- Requires network access to fetch documentation content via preferred mcp_microsoftdocs:microsoft_docs_fetch (from=learn-agent-skill) or fallback fetch_webpage (from=learn-agent-skill&accept=text/markdown).
When to use it
Use when authoring policy JSON, deploying via ARM/Bicep/Terraform, enforcing baselines, automating with DevOps, or using Machine Configuration, and other Azure Policy related development tasks.
What it can touch
Tools: claude-code, copilot, codex. It fetches remote documentation content using mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage as needed.
Caveats
Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation. Metadata freshness check may trigger a suggestion to update from repository.
# Azure Policy Skill This skill provides expert guidance for Azure Policy. Covers troubleshooting, best practices, decision making, architecture & design patterns, 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](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. - **Fallback**: Use `fetch_webpage` with query string `f
- How to Use This Skill
- Category Index
- Troubleshooting
- Best Practices
- Decision Making
- Architecture & Design Patterns
- Security
- Configuration
- Integrations & Coding Patterns
- Deployment
What does the azure-policy skill do?
Expert knowledge for Azure Policy development including troubleshooting, best practices, decision making, architecture & design patterns, security, configuration, integrations & coding patterns, and deployment. Use when authoring policy JSON, deploying via ARM/Bicep/Terraform, enforcing baselines, automating with DevOps, or using Machine Configuration, and other Azure Policy related development tasks. Not for Azure Blueprints (use azure-blueprints), Azure Resource Manager (use azure-resource-manager), Azure Role-based access control (use azure-rbac), Azure Security (use azure-security).
How do I install it?
Run `npx skills add MicrosoftDocs/Agent-Skills --skill azure-policy --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.