azure-search-nav
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'.
How do I install this agent skill?
npx skills add https://github.com/microsoft/azure-skills --skill azure-search-navIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill helps users navigate the Azure portal by generating deep links to specific resource blades based on search queries. It uses standard Microsoft Azure authentication and communication patterns.
- Socketwarn
1 alert: gptAnomaly
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
Azure 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 |
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/microsoft/azure-skills/azure-search-nav">View azure-search-nav on skillZs</a>