azure-discovery

Discover Azure Commercial or Government service and model availability and persist dated reports.

Updated Aug 1, 2026
One-click install
npx skills add https://github.com/QuyDu/Skills-Orchestrator --skill azure-discovery-quydu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: azure-discovery
Source: https://github.com/QuyDu/Skills-Orchestrator/tree/main/.github/skills/azure-discovery
Command: npx skills add https://github.com/QuyDu/Skills-Orchestrator --skill azure-discovery-quydu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Teams deploying to Azure Commercial or Azure US Government cannot assume which Cognitive Services kinds, OpenAI models, SKUs, or Speech resources exist in a given region or cloud, and manually probing each subscription is slow and error-prone. This Skill resolves the project's Azure environment once, authenticates the Azure CLI, and records dated discovery results so later work relies on verified availability instead of guesses. ## Core Features & Use Cases - Environment profile management: Resolves cloud precedence (explicit -Gov or -Commercial flag, then persisted profile, then Azure Commercial), stores nonsecret settings in the ignored .azure/environment.json, and syncs Azure MCP settings into .vscode/settings.json. - Read-only service discovery: Uses Azure CLI queries to enumerate Cognitive Services kinds and regions, select the best available OpenAI model with matching API version, and summarize existing Speech-capable accounts without recording names or identifiers. - Dated, schema-validated reports: Writes reports/azure-discovery.json and reports/azure-discovery.md with a UTC timestamp, and flags reports older than 14 days as stale. - Use Case: Before provisioning infrastructure for a new project in Azure US Government, run the Skill to confirm which OpenAI models and Speech regions are actually offered, then hand the persisted report to deployment planning. ## Quick Start Ask the agent to run azure-discovery for Azure Government and save the availability report for this project.

Frequently Asked Questions about azure-discovery

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check which Azure OpenAI models are available in my region?

Run the discovery workflow, which queries az cognitiveservices model list for the target location and selects the best match from a preference list including gpt-5.1, gpt-4.1, and gpt-4o. The chosen model name, version, SKU, and matching API version are written to reports/azure-discovery.json.

How do I discover services in Azure US Government versus Azure Commercial?

Pass the -Gov flag for AzureUSGovernment or -Commercial for AzureCloud. The selection is persisted in .azure/environment.json, so later runs reuse the saved cloud without asking again, and all Azure CLI queries are scoped to that cloud.

Does Azure discovery store subscription IDs or credentials?

No secrets are ever requested or recorded. Tenant and subscription identifiers are treated as nonsecret and stored only in the git-ignored .azure/environment.json local profile, while discovery reports exclude resource names, resource IDs, subscription IDs, tenant IDs, keys, and tokens.

Can discovery deploy or modify Azure resources?

No. Discovery is strictly read-only and never deploys resources or changes Azure state. Any deployment or external mutation requires a separate explicit approval gate, and discovery results alone never claim deployment readiness.

When is an Azure discovery report considered stale?

A report older than 14 days is identified as stale before it is relied upon. Each report carries a UTC discoveredAt timestamp so the age check is deterministic, and rerunning discovery refreshes both the JSON and Markdown outputs.

Why does discovery report a service as unavailable in my region?

Some Cognitive Services kinds are region-limited, especially in Azure US Government. The script enumerates every region offering a kind in the active cloud, so the report lists alternative regions when the target location has no offering, and query failures are recorded as unknown rather than hidden.