← Explore all skills

AZURE PORTAL NAVIGATION / Microsoft

Azure portal search links

Pins Microsoft's portal-link skill, which signs in with Connect-AzAccount or device code and only builds links for resource types listed as enabled.

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

01 / THE REASONING

Why this made the selection.

  • The file names authentication as Connect-AzAccount or device code with -UseDeviceAuthentication, and a 401 tells the operator to sign in again with the tenant that can access the subscription.
  • A resource type missing from the enabled-provider list is not given a link, and the plugin README says the skill returns links only and does not modify resources.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • .github/plugins/aks-skills/skills/azure-search-nav/SKILL.md
  • README.md
  • .github/plugins/aks-skills/README.md
  • LICENSE
  • .github/plugins/aks-skills/LICENSE

Our findings

  • Authentication is interactive Connect-AzAccount, or device code when -UseDeviceAuthentication is passed.
  • The workflow says the script signs in, calls the search API, and prints links rooted at https://portal.azure.com.
  • A 401 is treated as an invalid token or the wrong tenant, and the fix is to sign in with an account for that subscription's tenant.
  • If the provider is not in the enabled list, the file says to confirm the type rather than emit a link.
  • The plugin README says the skill returns links only and does not modify resources, and that it sends the Resource Manager access token to the portal search service.

Not established by this review

  • The resource was not executed and its tools were not called.
  • No Microsoft sign-in was performed and no portal search request was sent.
  • The PowerShell script, resource-type list, and its README were not opened.
  • The aks-skills plugin was not installed.
  • Not executed: it was not installed or run.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Add a skill to your workflow.

Upstream setup instructions ↗
  1. The aks-skills README tells Copilot CLI users to add marketplace microsoft/azure-skills and then shows `/plugin install aks-skills@azure-skills` inside a numbered line. That installs the aks-skills plugin, not this file alone, and it is not a line by itself.
  2. The repository README's own lines are `/plugin marketplace add microsoft/skills` and `/plugin install azure@skills`. Those name the azure plugin, which this plugin README says is separate.
  3. The repository README also shows `npx skills add microsoft/skills`, which starts a wizard for the whole repository.

Before you start

  • Copilot CLI if the plugin README's install steps are used
  • The Az.Accounts PowerShell module
  • An interactive Microsoft sign-in, or device-code sign-in in a headless session

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/skills/azure-search-nav/SKILL.md

    Supports: Connect-AzAccount or device code, 401 retry, and enabled-provider check

  2. https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/README.md

    Supports: token is sent to portal search, links only, no resource modification

  3. Repository README ↗Checked

    https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md

    Supports: MIT heading and the azure plugin install line

  4. Repository LICENSE ↗Checked

    https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE

    Supports: MIT License

  5. https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/LICENSE

    Supports: MIT License, same redistribution terms as the repository root

  6. https://raw.githubusercontent.com/microsoft/skills/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/skills/azure-search-nav/SKILL.md

    Supports: upstreamDescription, limitations, review.reviewedAt, review.notTested

Evidence & Ask