azure-search-nav — Claude Code skill: what it does, how to install
Creates Azure portal deep links to specific blades and menus for AKS, Arc-enabled Kubernetes, and Compute resources based on text queries.
/plugin marketplace add microsoft/skills
/plugin install aks-skills@skillsWhat azure-search-nav does
The skill takes a portal URL or a bare ARM resource ID together with a plain text query. Under the hood, it executes the PowerShell script references/Invoke-PortalSearchNav.ps1. The script queries the aks-search-direct-mid semantic search API and returns a deep link starting with https://portal.azure.com.
You need the Az.Accounts PowerShell module installed before running it. Authentication defaults to a browser window via Connect-AzAccount. In headless CLI environments without a window handle, the script fails unless you provide the -UseDeviceAuthentication switch.
Provider coverage is intentionally limited. The tool only supports resources under Microsoft.ContainerService, Microsoft.Kubernetes, and Microsoft.Compute registered in references/resource-types.json. Requests targeting any other resource provider trigger an error.
What it helps with
- build deep links to specific Azure portal blades using natural language
- locate menu items for AKS and Arc-enabled Kubernetes clusters
- generate target portal URLs from raw ARM resource IDs
- sign in to Azure from headless CLI environments using device-code login
Example prompts for the agent
- Find the portal blade for configuring node pools on this AKS resource:
/subscriptions/.../managedClusters/prod-aks. - Generate an Azure portal deep link to view networking settings for my virtual machine.
- Where in the Azure portal do I review diagnostic logs for this Arc Kubernetes cluster?
How to install azure-search-nav
1Plugin marketplace
/plugin marketplace add microsoft/skills/plugin install aks-skills@skillsThis installs the whole aks-skills plugin with all its skills
2Skills CLI (Vercel)
npx skills add microsoft/skills --skill azure-search-nav -a claude-code3Manually: put the files in place
~/.claude/skills/azure-search-nav/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/azure-search-nav/
Manually: put the files in place
.agents/skills/azure-search-nav/SKILL.mdFor all projects use ~/.agents/skills/
Manually: put the files in place
.cursor/skills/azure-search-nav/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install microsoft/skills azure-search-nav2Manually: put the files in place
.github/skills/azure-search-nav/SKILL.mdPlatform CLI
gemini skills install https://github.com/microsoft/skills --path .github/plugins/aks-skills/skills/azure-search-navManually: put the files in place
.devin/skills/azure-search-nav/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about azure-search-nav
How to install azure-search-nav in Claude Code?
Run /plugin marketplace add microsoft/skills and then install the plugin with /plugin install aks-skills@skills.
What does azure-search-nav do?
It matches a plain-language action request against Azure portal navigation items for supported resources and outputs a direct https://portal.azure.com link.
Which Azure resource types are supported by azure-search-nav?
The skill only handles resources in Microsoft.ContainerService, Microsoft.Kubernetes, and Microsoft.Compute that are listed in references/resource-types.json.
Source text
SKILL.md · MIT
--- name: azure-search-nav description: "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'." license: MIT metadata: author: Microsoft version: "1.0.1" --- # Azure Portal Search Link Builder ## Quick Reference | Item | Value | |------|-------| | Script | [`references/Invoke-PortalSearchNav.ps1`](references/Invoke-PortalSearchNav.ps1) | | Resource map | [`references/resource-types.json`](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 1. Collect **resource link** (portal URL or bare ARM resource ID) and **search query** from the user. 2. Run `references/Invoke-PortalSearchNav.ps1 -ResourceUrl '<link>' -Query '<query>'`. 3. The script signs in (browser by default; pass `-UseDeviceAuthentication` in headless/CLI environments), calls the search API, and prints portal deep links always rooted at `https://portal.azure.com`. See [references/README.md](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` |
© Microsoft · MIT · microsoft/skills
