CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

azure-advisor

Use Azure Advisor recommendations. WHEN: "show Advisor recommendations", "service retirements", "update recommendation status". DO NOT USE FOR: fixes or remediation (use azure-advisor-actionability).

Quality

87%

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

93%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 routing skill: a complete intent-to-tool table, a sequenced workflow with a confirmation gate for state-changing updates, honest error/truncation reporting requirements, and zero token waste. The only gap is the absence of an explicit error-recovery loop for failed recommendation-state updates.

DimensionReasoningScore

Conciseness

At ~27 lines the body is lean and assumes competence: no background on what Azure Advisor is, and every line instructs ('Prefer Azure Advisor MCP tools over Resource Graph or generic ARM tools', 'Never count a capped list', 'Resource-group scope requires a subscription'). Nothing is padded and nothing could be trimmed without losing guidance.

5 / 5

Actionability

Every intent maps to a named MCP tool — advisor_recommendation_summary, advisor_recommendation_list, advisor_recommendation_update, advisor_metadata_list/get, advisor_remediation_get — including the exact state-changing verbs ('Complete, dismiss, postpone, or reactivate') and scope rules. As an instruction-only skill the guidance is fully actionable and covers the common cases.

5 / 5

Workflow Clarity

The four-step Workflow is clearly sequenced and includes checkpoints for the risky operations: 'Confirm before recommendation-state updates' and 'Present only returned data, including truncation, access limitations, and errors'. Not 5 because there is no explicit error-recovery feedback loop (e.g., what to do when an advisor_recommendation_update call fails); not 3 because the state-update operation does have an explicit confirmation gate, so the missing-validation cap does not apply.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no bundle files, and the body is cleanly organized into Quick reference / Workflow / Safety sections with the single cross-skill pointer to azure-advisor-actionability clearly signaled ('Retrieve remediation → advisor_remediation_get, then azure-advisor-actionability'). This matches the simple-skill exception: well-organized sections alone warrant 5.

5 / 5

Total

19

/

20

Passed

Description

73%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 terse, well-structured description with excellent distinctiveness (explicit DO-NOT-USE boundary pointing to a sibling skill) and natural trigger phrases, but the core capability statement 'Use Azure Advisor recommendations' is generic and understates what the skill actually does. The WHEN clause is explicit and concrete, which anchors its completeness.

Suggestions

Replace the generic opening with the concrete capabilities, e.g. 'View, summarize, and update the status of Azure Advisor recommendations, including service retirements' so the 'what' is explicit rather than implied by triggers.

Add natural trigger synonyms users might say — e.g. 'dismiss or postpone a recommendation' or 'Advisor score' — to broaden keyword coverage toward the anchor-5 level.

DimensionReasoningScore

Specificity

The declarative 'what' is generic — 'Use Azure Advisor recommendations' names the domain with a single verb — and the only explicitly concrete action, 'update recommendation status', appears inside the WHEN trigger quotes rather than as a stated capability. Not 2 because a concrete action is explicitly stated beyond domain-naming; not 4 because the skill's other capabilities (summarize, list, browse metadata) are never stated as actions.

3 / 5

Completeness

Both parts are present: a 'what' ('Use Azure Advisor recommendations') and an explicit, concrete WHEN clause, so the missing-'Use when' cap at 3 does not apply. Not 5 because the 'what' is vague — it never states what the skill does with recommendations (view, aggregate, update status); not 3 because the 'when' is explicit with concrete trigger phrases.

4 / 5

Trigger Term Quality

The WHEN clause quotes natural user utterances — "show Advisor recommendations", "service retirements", "update recommendation status" — that a user would plausibly say. Not 5 because common variations and synonyms are missing (e.g., 'dismiss', 'postpone', 'Advisor score', 'Azure recommendations'); not 3 because these are specific natural phrases rather than generic or purely technical keywords.

4 / 5

Distinctiveness Conflict Risk

The description names a specific Azure service and adds an explicit exclusion boundary — 'DO NOT USE FOR: fixes or remediation (use azure-advisor-actionability)' — giving it a clear niche with distinct triggers and minimal conflict risk, matching the anchor-5 example structure.

5 / 5

Total

16

/

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/azure-advisor/skills/azure-advisor/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.