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

95%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

100%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.

The body is exemplary: lean tables, an immediately executable command, a clear single-purpose workflow with recovery guidance, and correct one-level-deep progressive disclosure into real bundle files. No weaknesses identified against the rubric.

DimensionReasoningScore

Conciseness

The ~47-line body is lean throughout: a quick-reference table, a three-step workflow, and an error table, with no explanation of concepts Claude already knows. Every section earns its place; not anchor 4 because there is no padding to trim anywhere.

5 / 5

Actionability

The workflow gives a copy-paste-ready command ("references/Invoke-PortalSearchNav.ps1 -ResourceUrl '<link>' -Query '<query>'"), the auth note names the exact headless flag (-UseDeviceAuthentication), and the error table supplies executable fixes such as "Install-Module Az.Accounts -Scope CurrentUser". The common case is fully covered.

5 / 5

Workflow Clarity

A simple single-action skill with an unambiguous sequence (collect resource link and query, run the script, receive deep links), and the error-handling table provides explicit recovery loops for 401, empty results, missing module, and headless sign-in failure. The operation is read-only, so the destructive-operation validation cap does not apply.

5 / 5

Progressive Disclosure

The body is a concise overview with well-signaled, one-level-deep references: the script, resource-types.json, and README.md for full parameter/API details — all three files exist in references/ and appropriately hold the bulk content (262-line script, 113-line README), keeping the SKILL.md itself clean.

5 / 5

Total

20

/

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 description that clearly and explicitly states what the skill does and when to use it, with natural trigger phrases and a highly distinct niche. The only gaps are minor: a single action verb limits action coverage, and a few natural synonyms ("navigate to", "where is the setting") are absent.

Suggestions

Broaden the what-clause with one or two additional concrete actions (e.g., "resolves a natural-language query to the matching portal blade") to move specificity toward comprehensive coverage.

Add common trigger variants such as "navigate to the right blade" or "where do I find this setting in the portal" to the WHEN clause for fuller synonym coverage.

DimensionReasoningScore

Specificity

The description states one concrete action ("Builds an Azure portal deep link to a specific blade/menu item") with precise scope: supported providers (Microsoft.ContainerService, Microsoft.Kubernetes, Microsoft.Compute) and the named search API. It sits above anchor 3 because the action is precisely scoped with enumerated resource types, but below anchor 5 because it lists only a single action rather than multiple concrete actions.

4 / 5

Completeness

It explicitly answers both questions: a third-person "what" (builds portal deep links via the aks-search-direct-mid semantic search API for listed resource types) and an explicit "when" with concrete quoted trigger phrases, matching the anchor-5 example structure exactly.

5 / 5

Trigger Term Quality

The WHEN clause quotes natural user phrasings — "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" — plus "blade/menu item" in the what-clause. Good coverage, but common variants like "navigate to", "where is the setting", or "take me to" are missing, so it falls short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The niche is highly specific — Azure portal deep-link construction for three named ARM resource providers via a particular search API — with trigger phrases that would not plausibly fire any other skill. Conflict risk is minimal.

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/GitHub-Copilot-for-Azure

Path

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.