azure-search-nav
Agent skill for Claude Code, Codex & Cursor from microsoft/azure-skills · updated
Cloud & DevOps Official
How to install azure-search-nav
$ npx skills add https://github.com/microsoft/azure-skills --skill azure-search-navAdvertisement
What azure-search-nav does
Builds an Azure portal deep link to a specific blade/menu item for supported Microsoft.ContainerService, Microsoft.Kubernetes, and Microsoft.Compute resources using the aks-search-direct-mid semantic search API. WHEN: 'find where in the Azure portal to do something', 'search the portal for an operation', 'construct a portal link from a search query and a resource'.
SKILL.md
View sourceAzure Portal Search Link Builder
Quick Reference
| Item | Value |
|---|---|
| Script | references/Invoke-PortalSearchNav.ps1 |
| Resource map | references/resource-types.json |
| Prerequisite | Az.Accounts PowerShell module |
| Auth | Interactive Microsoft sign-in (Connect-AzAccount), or device-code with -UseDeviceAuthentication |
When to Use This Skill
- User asks to find where in the Azure portal to perform an operation on a supported Container Service, Arc-enabled Kubernetes, or Compute resource.
- User wants a portal deep link for a specific blade/menu item.
- User provides a resource URL or ARM resource ID and a natural-language search query.
Workflow
- Collect resource link (portal URL or bare ARM resource ID) and search query from the user.
- Run
references/Invoke-PortalSearchNav.ps1 -ResourceUrl '<link>' -Query '<query>'. - The script signs in (browser by default; pass
-UseDeviceAuthenticationin headless/CLI environments), calls the search API, and prints portal deep links always rooted athttps://portal.azure.com.
See references/README.md for full parameter reference and API details.
Error Handling
| Error | Cause | Fix |
|---|---|---|
| Resource type not enabled | armProvider not in references/resource-types.json |
Confirm the type is in the enabled-provider list |
| 401 from API | Invalid token, or wrong tenant selected | Re-run and select the account with access to the target subscription's tenant |
| Empty results | No matching navigation item for the query | Try a different search term |
Az.Accounts not found |
Module not installed | Install-Module Az.Accounts -Scope CurrentUser |
| Browser sign-in fails (no window handle) | Headless/CLI environment | Re-run with -UseDeviceAuthentication |
Advertisement
More in Cloud & DevOps
canaryPost-deploy canary monitoring. (gstack)garrytan/gstackland-and-deployLand and deploy workflow. (gstack)garrytan/gstacksetup-deployConfigure deployment settings for /land-and-deploy.garrytan/gstackcaveman-discoverFind and label every LLM workflow in the repository so Caveman Cloud groups spend by workflow instead of one bucket. Use for "discover workflows" or breaking LLM spend down by workflow.juliusbrussee/cavemancaveman-evidence-reviewRead-only review of Caveman Cloud evidence: cost, Cave Score, workflows, traces, latency, errors, routing, savings. Use when asked what Caveman found or where LLM spend goes.juliusbrussee/caveman