CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

azure-advisor-actionability

Get remediation instructions for selected Azure Advisor recommendations. WHEN: fix a selected recommendation, generate remediation commands. DO NOT USE FOR: unused-resource discovery, savings or deletion prevalidation (use azure-advisor-cost-optimization).

Quality

90%

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

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 exceptionally lean, high-signal skill body: exact tool names, parameters, error states, and verbatim output labels, with a gated workflow and an explicit fallback loop. The only weakness is the absence of a worked example (a sample tool invocation or a before/after placeholder substitution), which would make the guidance fully copy-paste ready.

Suggestions

Add one example `advisor_remediation_get` invocation showing the `recommendationTypeId` GUID format to make the tool call copy-paste ready.

Include a short before/after example of placeholder substitution from a `resourceId` into a remediation step, so the 'preserve and describe unresolved placeholders' rule is concrete.

DimensionReasoningScore

Conciseness

The ~25-line body contains zero background exposition (no explanation of what Azure Advisor is) and no padding; every sentence is directive, e.g. "Call `advisor_remediation_get` once with only `recommendationTypeId`, never `resourceId`". It fully assumes Claude's competence, matching anchor 5.

5 / 5

Actionability

Guidance names the exact tool (`advisor_remediation_get`), its exact parameter, the exact error state (`RemediationNotFound`), and verbatim response labels ("Guidance source: Azure Advisor remediation tool"). As an instruction-only skill this is actionable without code, but minor gaps remain: no example invocation showing the parameter format and no example of a substituted placeholder in a final response, so it sits at anchor 4 rather than 5.

4 / 5

Workflow Clarity

The 5-step workflow has ordering gates ("before generating guidance", "After retrieval, substitute"), an explicit error-recovery loop (RemediationNotFound/empty → Microsoft Learn fallback → state unavailability, "never invent guidance"), and ambiguity checkpoints ("Ask which resource if ambiguous; never guess", "reuse known values, ask for missing values, never guess"). This matches anchor 5's explicit validation and feedback loops; anchor 4's 'minor validation gaps' does not apply.

5 / 5

Progressive Disclosure

This is a single-purpose skill under 50 lines with no external reference material needed, and no references/scripts/assets bundle exists. Per the rubric's simple-skill guideline, well-organized sections (Quick reference / Workflow / Final response) merit anchor 5 — and the sections are indeed clear and non-overlapping.

5 / 5

Total

19

/

20

Passed

Description

82%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 with an explicit what/when/when-not structure and clear disambiguation from a related cost-optimization skill. Its main limitation is that the 'what' condenses to a single core action, so it does not convey the full breadth of the skill's behavior. Trigger phrasing is natural but lacks common synonyms.

Suggestions

Broaden the 'what' clause to name the distinct capabilities, e.g. "Get remediation instructions for selected Azure Advisor recommendations, substitute resource-specific values, and cite Microsoft Learn fallback guidance."

Add natural trigger synonyms such as "resolve" or "address a recommendation" to the WHEN clause to widen keyword coverage.

DimensionReasoningScore

Specificity

The description names the domain ("Azure Advisor recommendations") and 1-2 concrete actions ("Get remediation instructions", "generate remediation commands"), but these are variations of a single core capability and omit other skill behaviors such as fallback documentation retrieval and guidance source labeling. It falls short of anchor 4, which expects several distinct specific actions listed.

3 / 5

Completeness

It explicitly answers both what ("Get remediation instructions for selected Azure Advisor recommendations") and when ("WHEN: fix a selected recommendation, generate remediation commands") with concrete trigger phrases, plus an explicit when-not clause. This matches the anchor-5 example structure; the 'when' is explicit and specific, so anchor 4 does not fit.

5 / 5

Trigger Term Quality

"fix a selected recommendation", "generate remediation commands", and "remediation instructions" are natural phrases a user would say when needing this skill. Coverage is good but not comprehensive — common synonyms like "resolve", "address", or "remediate this recommendation" are missing, keeping it below anchor 5.

4 / 5

Distinctiveness Conflict Risk

"DO NOT USE FOR: unused-resource discovery, savings or deletion prevalidation (use azure-advisor-cost-optimization)" explicitly disambiguates against the closest sibling skill, and the remediation-instructions niche has distinct triggers. Minimal conflict risk, matching anchor 5.

5 / 5

Total

17

/

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-actionability/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.