[New Skill]: azure-search-nav onboard to azure-skills/skills/azure-kubernetes

### Skill Name

azure-search-nav

### Contacts

Obi Michael (obimichael)

### Intended Agent Scenarios

Help customers navigate directly to a specific Azure portal blade or menu item for a supported Azure resource without manually searching the portal.

Intended scenarios include:
- Given an Azure portal resource URL or ARM resource ID and a natural-language operation, find the matching portal destination.
- Build a deep link for AKS tasks such as opening namespaces, Fleet Manager, Istio service mesh, upgrade configuration, alerts, or networking.
- Build a deep link for supported Virtual Machine management tasks.
- Return ranked matching destinations when a query can map to multiple portal menu items.

The skill parses the resource identifier, determines the ARM provider, searches indexed portal navigation metadata semantically, and reconstructs a resource-specific Azure portal deep link. This reduces navigation time and helps users reach features whose portal location or blade name is not obvious.

### Timeline

Q4 2026

### Additional Context

Skill package:
- `SKILL.md` defines activation guidance and the end-to-end workflow.
- `references/Invoke-PortalSearchNav.ps1` performs resource parsing, authentication, semantic search, and deep-link construction.
- `references/resource-types.json` maps supported ARM resource types to the canonical provider casing expected by the search index.
- `references/README.md` documents parameters, request construction, and resource-type onboarding.

Dependencies and authentication:
- Requires PowerShell and the `Az.Accounts` module.
- Uses interactive `Connect-AzAccount` authentication.
- Requests an Azure Management API access token and derives the issuing tenant ID from the token for the `App-Tenant-Id` request header.
- The signed-in identity must have access to the supplied Azure resource.

Search service:
- Endpoint: `https://pcnx-ai-etc5bra3fscchrew.b02.azurefd.net/aks-search-direct-mid`
- Request type: semantic search filtered by ARM provider and locale.
- Current default locale: `en.en-us`.

Initial resource scope:
- Azure Kubernetes Service managed clusters.
- Azure Virtual Machines.
- Additional resource types can be onboarded through `references/resource-types.json` after their navigation content is available in the search index.

The skill returns portal URLs and does not modify the target Azure resource.