Official agent skill

Azure Search Nav

by microsoft in microsoft/GitHub-Copilot-for-Azure

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…

OfficialMITAuto-check passedDevOps & Cloud

Install Azure Search Nav

skills CLI
$ npx skills add microsoft/GitHub-Copilot-for-Azure --skill azure-search-nav -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install microsoft/GitHub-Copilot-for-Azure azure-search-nav --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/microsoft/GitHub-Copilot-for-Azure.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/aks-skills/skills/azure-search-nav .claude/skills/azure-search-nav && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
azure-search-nav
GitHub stars
255
Token cost
~603 tokens
SKILL.md length
217 words
Files
5 (incl. references)
Skills in repo
61
Repo updated
First seen
Licence
MIT

At a glance

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…

  • Works in 3 steps: Collect resource link (portal URL or… → Run… → The script signs in (browser by default;…
  • Tasks that involve Container orchestration
  • SKILL.md covers Quick Reference, When to Use This Skill, Workflow and Error Handling
  • Runs PowerShell scripts from its folder; reaches portal.azure.com

What it does

Azure Search Nav is an agent skill from microsoft/GitHub-Copilot-for-Azure, published by the product's own GitHub organization. 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'.

Its SKILL.md is about 600 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/README.md`, `references/resource-types.json` and `version.json`).

It sits in DevOps & Cloud, covering Container orchestration. It works with Microsoft Azure and Kubernetes. The repository describes itself as: GitHub Copilot for Azure. The licence is MIT.

When your agent uses it

  • Tasks that involve Container orchestration

Example prompts

  • “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”
  • “/azure-search-nav”

Requirements

  • PowerShell

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Collect resource link (portal URL or bare ARM resource ID) and search query from the user.
  2. Run references/Invoke-PortalSearchNav.ps1 -ResourceUrl '' -Query ''.
  3. The script signs in (browser by default; pass -UseDeviceAuthentication in headless/CLI

What it can do on your machine

Read from SKILL.md and the folder at commit ce94fce. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (PowerShell), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • portal.azure.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Azure Search Nav loads about 603 tokens when it runs, and up to ~5.1k if it reads all its reference files. Until then it costs about 96 tokens; SKILL.md has 217 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~96
When it runs · the whole SKILL.md, loaded when a task matches
~603
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from microsoft/GitHub-Copilot-for-Azure at commit ce94fce, republished under its MIT licence (© microsoft). 217 words, ~603 tokens.

Download SKILL.mdSave it as .claude/skills/azure-search-nav/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
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
metadata.version
0.0.0-placeholder

Quick Reference

ItemValue
Scriptreferences/Invoke-PortalSearchNav.ps1
Resource mapreferences/resource-types.json
PrerequisiteAz.Accounts PowerShell module
AuthInteractive 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 for full parameter reference and API details.

Error Handling

ErrorCauseFix
Resource type not enabledarmProvider not in references/resource-types.jsonConfirm the type is in the enabled-provider list
401 from APIInvalid token, or wrong tenant selectedRe-run and select the account with access to the target subscription's tenant
Empty resultsNo matching navigation item for the queryTry a different search term
Az.Accounts not foundModule not installedInstall-Module Az.Accounts -Scope CurrentUser
Browser sign-in fails (no window handle)Headless/CLI environmentRe-run with -UseDeviceAuthentication

© microsoft, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (references) in plugins/aks-skills/skills/azure-search-nav of microsoft/GitHub-Copilot-for-Azure.

  • SKILL.md
  • references/Invoke-PortalSearchNav.ps1
  • references/README.md
  • references/resource-types.json
  • version.json

Open the folder on GitHubat commit ce94fce

Compare with similar skills

Azure Search Nav next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Azure Search Nav compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Azure Search Nav this skillmicrosoft/GitHub-Copilot-for-Azure255—~603Automated safety check: PassMIT
Provider Bug Reviewmondoohq/mql412—~2.9kAutomated safety check: PassCustom licence
Aspire MonitoringCommunityToolkit/Aspire629—~3.5kAutomated safety check: PassMIT
Kcli Cluster Deploymentkarmab/kcli653—~1.5kAutomated safety check: PassApache-2.0
Apex Azure Diagnosticsjonathan-vella/apex217—~2.1kAutomated safety check: PassMIT
Aks Deployment Skilltimothywarner/chatgptclass143—~916Automated safety check: PassCustom licence

Similar skills

  • Deep static code review of an mql provider for logic errors, nil-handling bugs, pagination truncation, caching/id collisions, and other defects that silently give users wrong data.

    412 GitHub stars~2.9k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Aspire Monitoring

    CommunityToolkit/Aspire

    ANALYSIS SKILL - Observe Aspire apps: logs, traces, metrics, resource state, telemetry export, browser telemetry, and the standalone dashboard.

    629 GitHub stars~3.5k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Guides deployment and management of Kubernetes clusters with kcli.

    653 GitHub stars~1.5k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Apex Azure Diagnostics

    jonathan-vella/apex

    WORKFLOW SKILL — Debug Azure production issues: Container Apps, Functions, App Service, AKS, VMs and messaging, with KQL log analysis.

    217 GitHub stars~2.1k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Aks Deployment Skill

    timothywarner/chatgptclass

    Deploy and operate workloads on Azure Kubernetes Service (AKS) the safe way.

    143 GitHub stars~916 tokensUpdated 20 days ago
    DevOps & CloudAuto-check passed
  • Ama Logs Update Charts Release Notes

    microsoft/Docker-Provider

    Official

    Prepare an ama-logs release PR: bump the image tag (X.Y.Z) across Helm charts, manifests, and Dockerfiles, and add a formatted ReleaseNotes.md entry.

    174 GitHub stars~2.6k tokensUpdated yesterday
    DevOps & CloudAuto-check passed

More from microsoft/GitHub-Copilot-for-Azure

All 61 skills in this repo
  • Capacity

    microsoft/GitHub-Copilot-for-Azure

    Official

    Discovers available Azure OpenAI model capacity across regions and projects.

    255 GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed
  • Deploy Model

    microsoft/GitHub-Copilot-for-Azure

    Official

    Unified Azure OpenAI model deployment skill with intelligent intent-based routing.

    255 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed
  • Azure Storage

    microsoft/GitHub-Copilot-for-Azure

    Official

    Azure Storage Services including Blob Storage, File Shares, Queue Storage, Table Storage, and Data Lake.

    255 GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check passed
  • Microsoft Foundry

    microsoft/GitHub-Copilot-for-Azure

    Official

    Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and resources end to end.

    255 GitHub starsUsed in 1 repo~6.7k tokens
    Auto-check passed
  • Entra Agent Id

    microsoft/GitHub-Copilot-for-Azure

    Official

    Provision Microsoft Entra Agent Identity Blueprints, BlueprintPrincipals, and per-instance Agent Identities via Microsoft Graph, and configure OAuth 2.0 token exchange (fmipath, OBO, cross-tenant)…

    255 GitHub starsUsed in 2 repos~4k tokens
    Auto-check passed
  • Azure Kubernetes Automatic Readiness

    microsoft/GitHub-Copilot-for-Azure

    Official

    Assess Kubernetes workloads and cluster configuration for AKS Automatic compatibility.

    255 GitHub starsUsed in 1 repo~4.4k tokens
    Auto-check passed

Categories

Questions about Azure Search Nav

What does Azure Search Nav do?

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…. Azure Search Nav is an agent skill from microsoft/GitHub-Copilot-for-Azure, published by the product's own GitHub organization.Compute resources using the aks-search-direct-mid semantic search API.

When should I use Azure Search Nav?

Azure Search Nav fits situations like: tasks that involve Container orchestration.

How do I install Azure Search Nav in Claude Code?

Run `npx skills add microsoft/GitHub-Copilot-for-Azure --skill azure-search-nav -a claude-code`. Or copy the skill folder (plugins/aks-skills/skills/azure-search-nav in microsoft/GitHub-Copilot-for-Azure) into .claude/skills/azure-search-nav in your project. Claude Code loads it when a task matches its description.

How do I install Azure Search Nav in Codex?

Run `npx skills add microsoft/GitHub-Copilot-for-Azure --skill azure-search-nav -a codex`. Or copy the skill folder (plugins/aks-skills/skills/azure-search-nav in microsoft/GitHub-Copilot-for-Azure) into .agents/skills/azure-search-nav in your project. Codex loads it when a task matches its description.

Can I use Azure Search Nav in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add microsoft/GitHub-Copilot-for-Azure --skill azure-search-nav -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/azure-search-nav, .gemini/skills/azure-search-nav, .github/skills/azure-search-nav and .opencode/skills/azure-search-nav in your project.

What does Azure Search Nav need to run?

Going by SKILL.md and its folder, Azure Search Nav needs PowerShell for the scripts in its folder. Our summary lists: PowerShell.

Does Azure Search Nav access the network?

SKILL.md names 1 domain. In commands or code: portal.azure.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Azure Search Nav safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Azure Search Nav use?

Azure Search Nav is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Azure Search Nav use?

About 603 tokens (SKILL.md is roughly 2.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4.5k tokens, read only when the agent opens those files.

What are the alternatives to Azure Search Nav?

Skills that share tags, products or a category with Azure Search Nav: Provider Bug Review (mondoohq/mql, 412 stars), Aspire Monitoring (CommunityToolkit/Aspire, 629 stars), Kcli Cluster Deployment (karmab/kcli, 653 stars) and Apex Azure Diagnostics (jonathan-vella/apex, 217 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Azure Search Nav?

microsoft (a GitHub organization, an official publisher) maintains it in microsoft/GitHub-Copilot-for-Azure, which has 255 GitHub stars. The repository holds 61 skills in this directory. The repository was last updated on October 9, 2026.

Source: microsoft/GitHub-Copilot-for-Azure on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.