Official agent skill

Azure Resource Lookup

by microsoft in microsoft/GitHub-Copilot-for-Azure

List, find, and show Azure resources across subscriptions or resource groups.

OfficialMITAuto-check passedAgent Workflows

Install Azure Resource Lookup

skills CLI
$ npx skills add microsoft/GitHub-Copilot-for-Azure --skill azure-resource-lookup -a claude-code

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

GitHub CLI
$ gh skill install microsoft/GitHub-Copilot-for-Azure azure-resource-lookup --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/microsoft/GitHub-Copilot-for-Azure.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/azure-skills/skills/azure-resource-lookup .claude/skills/azure-resource-lookup && 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-resource-lookup
GitHub stars
255
Used in
1 other repo
Token cost
~1.4k tokens
SKILL.md length
541 words
Files
3 (incl. references)
Skills in repo
61
Repo updated
First seen
Licence
MIT

At a glance

List, find, and show Azure resources across subscriptions or resource groups.

  • Works in 3 steps: Check for a Dedicated MCP Tool → Generate the ARG Query → Execute and Format Results
  • : list websites
  • SKILL.md covers When to Use This Skill, Quick Reference, MCP Tools and Workflow, plus 2 more sections
  • Calls az

What it does

Azure Resource Lookup is an agent skill from microsoft/GitHub-Copilot-for-Azure, published by the product's own GitHub organization. List, find, and show Azure resources across subscriptions or resource groups. Handles prompts like "list the websites in my subscription", "list my web apps", "show my app services", "list virtual machines", "list my VMs", "show storage accounts", "find container apps", and "what resources do I have". USE FOR: list websites, list web apps, list app services, show websites in subscription, resource inventory, find resources by tag, tag analysis, orphaned resource discovery (not for cost analysis), unattached…

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/azure-resource-graph.md` and `version.json`).

It sits in Agent Workflows, covering MCP servers. It works with Microsoft Azure and Model Context Protocol. The repository describes itself as: GitHub Copilot for Azure. The licence is MIT.

When your agent uses it

  • : list websites
  • List app services
  • Show websites in subscription
  • Resource inventory

Example prompts

  • “list the websites in my subscription”
  • “list my web apps”
  • “show my app services”
  • “/azure-resource-lookup”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Check for a Dedicated MCP Tool
  2. Generate the ARG Query
  3. Execute and Format Results

What it can do on your machine

Read from SKILL.md and the folder at commit ce94fce. 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

    Shell commands in SKILL.md call:

    • az

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

  • Network

    No URLs in SKILL.md. Its commands use az, 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 Resource Lookup loads about 1.4k tokens when it runs, and up to ~2.6k if it reads all its reference files. Until then it costs about 198 tokens; SKILL.md has 541 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from microsoft/GitHub-Copilot-for-Azure at commit ce94fce, republished under its MIT licence (© microsoft). 541 words, ~1,378 tokens.

Download SKILL.mdSave it as .claude/skills/azure-resource-lookup/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
azure-resource-lookup
description
List, find, and show Azure resources across subscriptions or resource groups. Handles prompts like "list the websites in my subscription", "list my web apps", "show my app services", "list virtual machines", "list my VMs", "show storage accounts", "find container apps", and "what resources do I have". USE FOR: list websites, list web apps, list app services, show websites in subscription, resource inventory, find resources by tag, tag analysis, orphaned resource discovery (not for cost analysis), unattached disks, count resources by type, cross-subscription lookup, and Azure Resource Graph queries. DO NOT USE FOR: deploying/changing resources (use azure-deploy), cost optimization (use cost-optimization from the optional azure-cost plugin), or non-Azure clouds.
license
MIT
metadata.author
Microsoft
metadata.version
0.0.0-placeholder

Azure Resource Lookup

List, find, and discover Azure resources of any type across subscriptions and resource groups. Use Azure Resource Graph (ARG) for fast, cross-cutting queries when dedicated MCP tools don't cover the resource type.

When to Use This Skill

Use this skill when the user wants to:

  • List resources of any type (VMs, web apps, storage accounts, container apps, databases, etc.)
  • Show resources in a specific subscription or resource group
  • Query resources across multiple subscriptions or resource types
  • Find orphaned resources (unattached disks, unused NICs, idle IPs)
  • Discover resources missing required tags or configurations
  • Get a resource inventory spanning multiple types
  • Find resources in a specific state (unhealthy, failed provisioning, stopped)
  • Answer "what resources do I have?" or "show me my Azure resources"
  • List web apps, websites, or App Services

⚠️ Warning: App Service / Web Apps have no dedicated MCP list command. Prompts like "list websites", "list web apps", or "list app services" must route through this skill to use Azure Resource Graph.

💡 Tip: For single-resource-type queries, first check if a dedicated MCP tool can handle it (see routing table below). If none exists, use Azure Resource Graph.

Quick Reference

PropertyValue
Query LanguageKQL (Kusto Query Language subset)
CLI Commandaz graph query -q "<KQL>" -o table
Extensionaz extension add --name resource-graph
MCP Toolextension_cli_generate with intent for az graph query
Best ForCross-subscription queries, orphaned resources, tag audits

MCP Tools

ToolPurposeWhen to Use
extension_cli_generateGenerate az graph query commandsPrimary tool — generate ARG queries from user intent
mcp_azure_mcp_subscription_listList available subscriptionsDiscover subscription scope before querying
mcp_azure_mcp_group_listList resource groupsNarrow query scope

Workflow

Show full SKILL.md (272 more words)Show less
Step 1: Check for a Dedicated MCP Tool

For single-resource-type queries, check if a dedicated MCP tool can handle it:

Resource TypeMCP ToolCoverage
Virtual Machinescompute✅ Full — list, details, sizes
Storage Accountsstorage✅ Full — accounts, blobs, tables
Cosmos DBcosmos✅ Full — accounts, databases, queries
Key Vaultkeyvault⚠️ Partial — secrets/keys only, no vault listing
SQL Databasessql⚠️ Partial — requires resource group name
Container Registriesacr✅ Full — list registries
Kubernetes (AKS)aks✅ Full — clusters, node pools
App Service / Web Appsappservice❌ No list command — use ARG
Container Apps—❌ No MCP tool — use ARG
Event Hubseventhubs✅ Full — namespaces, hubs
Service Busservicebus✅ Full — queues, topics

If a dedicated tool is available with full coverage, use it. Otherwise proceed to Step 2.

Step 2: Generate the ARG Query

Use extension_cli_generate to build the az graph query command:

yaml
mcp_azure_mcp_extension_cli_generate
  intent: "query Azure Resource Graph to <user's request>"
  cli-type: "az"

See Azure Resource Graph Query Patterns for common KQL patterns.

Step 3: Execute and Format Results

Run the generated command. Use --query (JMESPath) to shape output:

bash
az graph query -q "<KQL>" --query "data[].{name:name, type:type, rg:resourceGroup}" -o table

Use --first N to limit results. Use --subscriptions to scope.

Error Handling

ErrorCauseFix
resource-graph extension not foundExtension not installedaz extension add --name resource-graph
AuthorizationFailedNo read access to subscriptionCheck RBAC — need Reader role
BadRequest on queryInvalid KQL syntaxVerify table/column names; use =~ for case-insensitive type matching
Empty resultsNo matching resources or wrong scopeCheck --subscriptions flag; verify resource type spelling

Constraints

  • ✅ Always use =~ for case-insensitive type matching (types are lowercase)
  • ✅ Always scope queries with --subscriptions or --first for large tenants
  • ✅ Prefer dedicated MCP tools for single-resource-type queries
  • ❌ Never use ARG for real-time monitoring (data has slight delay)
  • ❌ Never attempt mutations through ARG (read-only)

© microsoft, 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 2 other files (references) in plugins/azure-skills/skills/azure-resource-lookup of microsoft/GitHub-Copilot-for-Azure.

  • SKILL.md
  • references/azure-resource-graph.md
  • version.json

Open the folder on GitHubat commit ce94fce

Used in 3 other repositories

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

Compare with similar skills

Azure Resource Lookup 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 Resource Lookup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Azure Resource Lookup this skillmicrosoft/GitHub-Copilot-for-Azure2551 repos~1.4kAutomated safety check: PassMIT
Azsdk Common Pipeline TroubleshootingAzure/azure-sdk-for-android121—~496Automated safety check: PassMIT
Azure Typespec AuthorAzure/azure-sdk-tools134—~1.9kAutomated safety check: PassMIT
Azure Typespec AuthorAzure/azure-sdk-tools134—~1.8kAutomated safety check: PassMIT
Microsoft Docsmicrosoft/ai-agents-for-beginners77k—~1.5kAutomated safety check: PassMIT
Setupfcakyon/claude-codex-settings1.2k—~156Automated safety check: PassApache-2.0

Similar skills

  • Azsdk Common Pipeline Troubleshooting

    Azure/azure-sdk-for-android

    Official

    Diagnose and resolve failures in Azure SDK CI and generation pipelines.

    121 GitHub stars~496 tokensUpdated 4 mo ago
    Agent WorkflowsAuto-check passed
  • Azure Typespec Author

    Azure/azure-sdk-tools

    Official

    Authors and modifies Azure TypeSpec (.tsp) API specifications.

    134 GitHub stars~1.9k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Azure Typespec Author

    Azure/azure-sdk-tools

    Official

    Authors and modifies Azure TypeSpec (.tsp) API specifications.

    134 GitHub stars~1.8k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Microsoft Docs

    microsoft/ai-agents-for-beginners

    Official

    Küsib ametlikku Microsofti dokumentatsiooni, et leida mõisteid, juhendeid ja koodinäiteid Azure'i, .NET-i, Agent Frameworki, Aspire'i, VS Code'i, GitHubi ja muu kohta.

    77k GitHub stars~1.5k tokensUpdated 20 days ago
    Agent WorkflowsAuto-check passed
  • Setup

    fcakyon/claude-codex-settings

    This skill should be used when user encounters "Azure MCP error", "Azure authentication failed", "az login required", "Azure CLI not found", or needs help configuring Azure MCP integration.

    1.2k GitHub stars~156 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Official

    Detect and mitigate SDK Breaking changes for an SDK package which is generated from TypeSpec.

    134 GitHub stars~1.2k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from microsoft/GitHub-Copilot-for-Azure

All 61 skills in this repo
  • Capacity

    microsoft/GitHub-Copilot-for-Azure

    Official

    Discovers available Azure OpenAI model capacity across regions and projects.

    255 GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed
  • Deploy Model

    microsoft/GitHub-Copilot-for-Azure

    Official

    Unified Azure OpenAI model deployment skill with intelligent intent-based routing.

    255 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed
  • Azure Storage

    microsoft/GitHub-Copilot-for-Azure

    Official

    Azure Storage Services including Blob Storage, File Shares, Queue Storage, Table Storage, and Data Lake.

    255 GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check passed
  • Microsoft Foundry

    microsoft/GitHub-Copilot-for-Azure

    Official

    Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and resources end to end.

    255 GitHub starsUsed in 1 repo~6.7k tokens
    Auto-check passed
  • Entra Agent Id

    microsoft/GitHub-Copilot-for-Azure

    Official

    Provision Microsoft Entra Agent Identity Blueprints, BlueprintPrincipals, and per-instance Agent Identities via Microsoft Graph, and configure OAuth 2.0 token exchange (fmipath, OBO, cross-tenant)…

    255 GitHub starsUsed in 2 repos~4k tokens
    Auto-check passed
  • Azure Kubernetes Automatic Readiness

    microsoft/GitHub-Copilot-for-Azure

    Official

    Assess Kubernetes workloads and cluster configuration for AKS Automatic compatibility.

    255 GitHub starsUsed in 1 repo~4.4k tokens
    Auto-check passed

Categories

Questions about Azure Resource Lookup

What does Azure Resource Lookup do?

List, find, and show Azure resources across subscriptions or resource groups. Azure Resource Lookup is an agent skill from microsoft/GitHub-Copilot-for-Azure, published by the product's own GitHub organization. List, find, and show Azure resources across subscriptions or resource groups.

When should I use Azure Resource Lookup?

Azure Resource Lookup fits situations like: : list websites; list app services; show websites in subscription; resource inventory.

How do I install Azure Resource Lookup in Claude Code?

Run `npx skills add microsoft/GitHub-Copilot-for-Azure --skill azure-resource-lookup -a claude-code`. Or copy the skill folder (plugins/azure-skills/skills/azure-resource-lookup in microsoft/GitHub-Copilot-for-Azure) into .claude/skills/azure-resource-lookup in your project. Claude Code loads it when a task matches its description.

How do I install Azure Resource Lookup in Codex?

Run `npx skills add microsoft/GitHub-Copilot-for-Azure --skill azure-resource-lookup -a codex`. Or copy the skill folder (plugins/azure-skills/skills/azure-resource-lookup in microsoft/GitHub-Copilot-for-Azure) into .agents/skills/azure-resource-lookup in your project. Codex loads it when a task matches its description.

Can I use Azure Resource Lookup 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 microsoft/GitHub-Copilot-for-Azure --skill azure-resource-lookup -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-resource-lookup, .gemini/skills/azure-resource-lookup, .github/skills/azure-resource-lookup and .opencode/skills/azure-resource-lookup in your project.

What does Azure Resource Lookup need to run?

Going by SKILL.md and its folder, Azure Resource Lookup needs the command-line tools its instructions call (az).

Does Azure Resource Lookup access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Azure Resource Lookup 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. Review the folder before installing.

What licence does Azure Resource Lookup use?

Azure Resource Lookup is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Azure Resource Lookup use?

About 1.4k tokens (SKILL.md is roughly 5.5k 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 1.3k tokens, read only when the agent opens those files.

What are the alternatives to Azure Resource Lookup?

Skills that share tags, products or a category with Azure Resource Lookup: Azsdk Common Pipeline Troubleshooting (Azure/azure-sdk-for-android, 121 stars), Azure Typespec Author (Azure/azure-sdk-tools, 134 stars), Azure Typespec Author (Azure/azure-sdk-tools, 134 stars) and Microsoft Docs (microsoft/ai-agents-for-beginners, 77k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Azure Resource Lookup?

microsoft (a GitHub organization, an official publisher) maintains it in microsoft/GitHub-Copilot-for-Azure, which has 255 GitHub stars. The repository holds 61 skills in this directory. The repository was last updated on October 9, 2026.

Source: microsoft/GitHub-Copilot-for-Azure on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.