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.
- 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.
- 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.
- 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.
- azure-search-nav SKILL.md ↗Checked
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
- AKS skills plugin README ↗Checked
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
- Repository README ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md
Supports: MIT heading and the azure plugin install line
- Repository LICENSE ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE
Supports: MIT License
- AKS skills plugin LICENSE ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/LICENSE
Supports: MIT License, same redistribution terms as the repository root
https://raw.githubusercontent.com/microsoft/skills/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/skills/azure-search-nav/SKILL.md
Supports: upstreamDescription, limitations, review.reviewedAt, review.notTested