mcpField
A
azure-resource-graph

azure-resource-graph

github.com/microsoftdocsCloud & DevOps796186 installsUpdated 3d ago
Repository

About azure-resource-graph

A guidance skill for Azure Resource Graph, aimed at Agents working with queries, configuration, and operations. It combines local references with network-fetched documentation.

Key features

  1. 01Troubleshooting query and integration issues
  2. 02Query design and throttling guidance
  3. 03Limits, quotas, and pagination
  4. 04Configuration and shared queries
  5. 05CLI, PowerShell, REST, and reporting patterns

Use cases

  1. 01Diagnosing query errors or connector problems
  2. 02Planning efficient queries and pagination
  3. 03Automating queries through CLI or Logic Apps

MCP support

Uses mcp_microsoftdocs tools to fetch Microsoft documentation when available; otherwise it describes a webpage-fetch fallback.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-resource-graph

After installing, type/azure-resource-graphin Claude Code to confirm it loaded.

Details

From the project README

Azure Resource Graph Skill

This skill provides expert guidance for Azure Resource Graph. Covers troubleshooting, best practices, decision making, limits & quotas, configuration, and integrations & coding patterns. 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
TroubleshootingL34-L40Diagnosing and fixing Azure Resource Graph issues with alerts, query syntax/runtime errors, and Power BI connector connectivity, auth, and data refresh problems.
Best PracticesL41-L45Guidance on designing Azure Resource Graph queries to avoid throttling, including efficient patterns, batching, pagination, and performance-friendly query structures.
Decision MakingL46-L51Guidance on selecting efficient Azure Resource Graph query patterns and deciding when to use the GET/LIST APIs versus the Query service for different scenarios.
Limits & QuotasL52-L59Understanding ARG request limits, pagination behavior, handling large result sets, and implementing efficient paging (including with PowerShell) to avoid quota issues.
ConfigurationL60-L67Configuring Resource Graph usage: keyboard shortcuts, supported resource types, and defining/deploying shared queries via Bicep and ARM templates.
Integrations & Coding PatternsL68-L79Running Resource Graph queries via CLI, PowerShell, REST, Logic Apps, Power BI; creating shared queries and alerts; and retrieving resource change history for automation and reporting.
Troubleshooting
TopicURL
Troubleshoot Azure Resource Graph alert integration issueshttps://learn.microsoft.com/en-us/azure/governance/resource-graph/troubleshoot/alerts
Resolve common Azure Resource Graph query errorshttps://learn.microsoft.com/en-us/azure/governance/resource-graph/troubleshoot/general
Troubleshoot Azure Resource Graph Power BI connector problemshttps://learn.microsoft.com/en-us/azure/governance/resource-graph/troubleshoot/power-bi-connector
Best Practices
TopicURL
Avoid Azure Resource Graph throttling with query patternshttps://learn.microsoft.com/en-us/azure/governance/resource-graph/concepts/guidance-for-throttled-requests
Decision Making
TopicURL
Select the right Azure Resource Graph query strategyhttps://learn.microsoft.com/en-us/azure/governance/resource-graph/choose-query-strategy
Choose between ARG GET/LIST API and Query servicehttps://learn.microsoft.com/en-us/azure/governance/resource-graph/concepts/get-list-query-service-differences
Limits & Quotas
TopicURL
Use Azure Resource Graph GET/LIST API quotas effectivelyhttps://learn.microsoft.com/en-us/azure/governance/resource-graph/concepts/azure-resource-graph-get-list-api
Azure Resource Graph pagination behavior and limitshttps://learn.microsoft.com/en-us/azure/governance/resource-graph/concepts/paging-results
Handle large Azure Resource Graph datasets and limitshttps://learn.microsoft.com/en-us/azure/governance/resource-graph/concepts/work-with-data
Paginate Azure Resource Graph results with PowerShellhttps://learn.microsoft.com/en-us/azure/governance/resource-graph/paginate-powershell
Configuration
TopicURL
Use keyboard shortcuts in Azure Resource Graph Explorerhttps://learn.microsoft.com/en-us/azure/governance/resource-graph/reference/keyboard-shortcuts
Reference of Azure Resource Graph supported resource typeshttps://learn.microsoft.com/en-us/azure/governance/resource-graph/reference/supported-tables-resources
Define Azure Resource Graph shared queries using Bicephttps://learn.microsoft.com/en-us/azure/governance/resource-graph/shared-query-bicep
Deploy Azure Resource Graph shared queries with ARM templateshttps://learn.microsoft.com/en-us/azure/governance/resource-graph/shared-query-template
Integrations & Coding Patterns
TopicURL
Create Azure Resource Graph-based alerts with Log Analyticshttps://learn.microsoft.com/en-us/azure/governance/resource-graph/alerts-query-quickstart
Query Azure Resource Graph for resource change historyhttps://learn.microsoft.com/en-us/azure/governance/resource-graph/changes/get-resource-changes
Run Azure Resource Graph queries with Azure CLIhttps://learn.microsoft.com/en-us/azure/governance/resource-graph/first-query-azurecli
Query Azure Resource Graph using PowerShell cmdletshttps://learn.microsoft.com/en-us/azure/governance/resource-graph/first-query-powershell
Call Azure Resource Graph via REST APIhttps://learn.microsoft.com/en-us/azure/governance/resource-graph/first-query-rest-api
Use Azure Resource Graph Power BI connector for querieshttps://learn.microsoft.com/en-us/azure/governance/resource-graph/power-bi-connector-quickstart
Create Azure Resource Graph shared queries with CLIhttps://learn.microsoft.com/en-us/azure/governance/resource-graph/shared-query-azure-cli
Create Azure Resource Graph shared queries with PowerShellhttps://learn.microsoft.com/en-us/azure/governance/resource-graph/shared-query-azure-powershell
Automate Azure Resource Graph queries with Logic Appshttps://learn.microsoft.com/en-us/azure/governance/resource-graph/tutorials/logic-app-calling-arg

Comments

Markdown supported