CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

azure-search-nav

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

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

The canonical home for this skill is azure-search-nav in microsoft/GitHub-Copilot-for-Azure

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exemplary lean skill body: concise tables, an executable command, a clear workflow, and an error-handling table that doubles as recovery feedback loops, with detail properly pushed to real one-level-deep reference files. The single gap is the absence of a worked invocation example with realistic values and expected output in the body itself.

Suggestions

Add one worked example in the Workflow section with realistic values (e.g. a managedCluster portal URL and query 'image cleaner') plus a line of expected output, so the common case is fully covered without opening references/README.md.

Briefly state what the script's printed output looks like (a list of portal deep links rooted at https://portal.azure.com) so Claude knows how to interpret and present the results to the user.

DimensionReasoningScore

Conciseness

The body is lean and table-driven with zero padding: a Quick Reference table, a three-step workflow, and an error table. It assumes Claude's competence, explains no general concepts, and every token earns its place, matching the anchor-5 'lean and efficient' profile.

5 / 5

Actionability

The workflow gives a copy-paste-ready command ('references/Invoke-PortalSearchNav.ps1 -ResourceUrl '<link>' -Query '<query>'') plus a concrete install command in the error table. It falls short of anchor 5 because the body itself lacks a worked example with realistic argument values or a sample of the script's output (that example lives only in references/README.md), leaving a minor gap for the most common case.

4 / 5

Workflow Clarity

The sequence is unambiguous (collect resource link and query, run the script, read the emitted portal links), and the Error Handling table supplies explicit error-to-fix feedback loops (401 → re-run selecting the correct tenant; no window handle → re-run with -UseDeviceAuthentication; empty results → retry a different term). The operation is read-only link building, so the destructive/batch validation cap does not apply.

5 / 5

Progressive Disclosure

The ~45-line body is a clean overview that delegates detail to well-signaled, one-level-deep references (references/README.md for full parameter/API details, plus the script and resource-types.json), all of which exist in the bundle. Navigation via the Quick Reference table is easy, matching the anchor-5 structure.

5 / 5

Total

19

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong third-person description that states a precisely qualified capability and pairs it with an explicit WHEN clause of natural trigger phrases. Its only weakness is that it names a single action and could include a couple more natural trigger synonyms.

DimensionReasoningScore

Specificity

The description fully qualifies its single concrete action — 'Builds an Azure portal deep link to a specific blade/menu item ... using the aks-search-direct-mid semantic search API' — with the mechanism and supported provider namespaces named, which is noticeably more concrete than the anchor-3 '1-2 concrete actions, not comprehensive' example. It falls short of anchor 5 only because it lists one action rather than multiple, so the coverage is not comprehensive across several operations.

4 / 5

Completeness

It clearly answers both questions: 'what' (builds a portal deep link to a blade/menu item for the listed resource providers via the named search API) and 'when' (explicit WHEN: clause with three concrete trigger phrases), matching the anchor-5 example structure exactly.

5 / 5

Trigger Term Quality

The WHEN clause offers natural phrases users would actually say ('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'). Good coverage, but a few natural variations are missing (e.g. 'where do I configure X in the portal', 'navigate to the blade'), so it does not reach the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche — constructing Azure portal deep links via a specific search API for three enumerated ARM providers — with triggers ('find where in the Azure portal', 'construct a portal link') that are unlikely to fire for unrelated skills, giving minimal conflict risk.

5 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

microsoft/azure-skills

Path

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

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.