Azure Search Nav — Agent Skill by Microsoft

From the author

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'.

— the description by Microsoft

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The azure-search-nav skill provides a PowerShell-based utility to generate direct deep links into the Azure portal. By leveraging the aks-search-direct-mid semantic search API, it allows users to translate natural-language queries into specific navigation paths for supported Microsoft.ContainerService, Microsoft.Kubernetes, and Microsoft.Compute resources. The tool handles authentication via Az.Accounts, parses resource identifiers, and constructs precise portal URLs, streamlining the process of locating specific configuration blades or menu items.

What it does

Parses Azure portal URLs and ARM resource IDs to extract necessary context.
Authenticates users via standard Azure PowerShell account modules.
Queries the semantic search API to map natural language to portal navigation paths.
Constructs and outputs direct deep links to specific resource blades.
Supports extensibility for additional resource types via a configuration file.
Provides options for both interactive browser-based and headless device-code authentication.

When to use it

When you need to find the exact location of a setting or operation within the Azure portal.
When you want to generate a shareable deep link for a specific resource blade.
When working with supported Container Service, Arc-enabled Kubernetes, or Compute resources.
When automating navigation tasks in a CLI or scripted environment.

Advantages

Reduces manual navigation time within the complex Azure portal interface.
Uses semantic search to interpret intent rather than requiring exact menu path knowledge.
Integrates directly with existing Azure PowerShell authentication workflows.
Provides a consistent, programmatic way to access deep links across different resource types.

Usage examples

“Find the image cleaner settings for my AKS cluster.”: The script queries the search API for 'image cleaner' relative to the provided cluster resource ID and returns a direct link to the corresponding portal blade.
“Generate a portal link to the virtual machine scale set networking blade.”: The tool parses the VMSS resource ID, queries the navigation index, and outputs a URL that opens the specific networking configuration page in the Azure portal.

Install

Download the skill as a ZIP:
https://mp-staging.autogineer.com/agent-skills/microsoft/azure-search-nav/download

Unzip it into the cross-client skills folder of your project:

mkdir -p .agents/skills && unzip azure-search-nav.zip -d .agents/skills

Documentation by Microsoft

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 -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 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`

Files

ATTRIBUTION.mdAdded by AutoGineer974 B
LICENSELicence file added by AutoGineer1.1 KiB
SKILL.md2.3 KiB
references/Invoke-PortalSearchNav.ps1Script9.6 KiB
references/README.md3.8 KiB
references/resource-types.json4.3 KiB

ATTRIBUTION.md

Attribution

This folder is an unmodified copy of the Agent Skill "azure-search-nav", distributed by AutoGineer (https://autogineer.com/agent-skills).

Source: https://github.com/microsoft/skills/tree/0696600436a9669184ce47e8d8b2ceac62e4bfac/.github/plugins/aks-skills/skills/azure-search-nav
Commit: 0696600436a9669184ce47e8d8b2ceac62e4bfac
Created by: Microsoft (https://github.com/microsoft/skills/tree/0696600436a9669184ce47e8d8b2ceac62e4bfac/.github/plugins/aks-skills/skills/azure-search-nav)
Publisher: Microsoft (https://github.com/microsoft)
Licence: MIT License (https://spdx.org/licenses/MIT.html)
Licence evidence: declared in the frontmatter ("license: MIT")
Retrieved: 2026-11-07

The skill's own files are unmodified copies. AutoGineer is not affiliated with or endorsed by the author or the publisher.

Files added by AutoGineer

ATTRIBUTION.md: this file, written by AutoGineer
LICENSE: copied from .github/plugins/aks-skills/LICENSE

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

What our scanner noticed· Low risk

Scripts that your agent may run

This skill includes scripts that your agent may run. Read them before you use it.

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Modal
K-Dense· Community
A serverless cloud platform for deploying and scaling Python applications, AI models, and GPU-accelerated workloads.
Cloud and DevOpsClaude CodeClaude appsOpenAI Codex+14 more
Apache-2.0Low riskGitHub stars of the source repository56.4k
Cloud Infrastructure Network Engineer
Seth Hobson· Community
An expert network engineer persona specializing in cloud architecture, security, and performance optimization.
Cloud and DevOpsClaude Code
MITGitHub stars of the source repository42.3k
Deployment Validation Cloud Architect
Seth Hobson· Community
Expert cloud architect for multi-cloud infrastructure, cost optimization, and resilient system design.
Cloud and DevOpsClaude Code
MITGitHub stars of the source repository42.3k
Airflow Dag Patterns
Seth Hobson· Community
Best practices and design patterns for building and maintaining production-ready Apache Airflow DAGs.
Cloud and DevOpsClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k
Cost Optimization
Seth Hobson· Community
A comprehensive framework for reducing cloud infrastructure costs across AWS, Azure, GCP, and OCI.
Cloud and DevOpsClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k
Hybrid Cloud Networking
Seth Hobson· Community
A guide to configuring secure, high-performance network connectivity between on-premises infrastructure and major cloud providers.
Cloud and DevOpsClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download azure-search-nav.zip