mcpField
A
azure-advisor-actionability

azure-advisor-actionability

github.com/microsoftCloud & DevOps1.6k67 installsUpdated today
Repository

About azure-advisor-actionability

A skill for turning Azure Advisor recommendations into sourced remediation steps for Azure customers. It retrieves available remediation or Microsoft Learn guidance, preserves warnings and verification steps, and never executes changes without confirmation.

Key features

  1. 01Retrieve Advisor remediation guidance
  2. 02Use Microsoft Learn when remediation is unavailable
  3. 03Require exact recommendation and resource identifiers
  4. 04Preserve step order, warnings, and verification
  5. 05Separate Azure CLI and PowerShell steps

Use cases

  1. 01Prepare remediation steps for an Azure recommendation
  2. 02Resolve missing or ambiguous resource identifiers
  3. 03Explain when no verified remediation guidance is available

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/microsoft/azure-skills --skill azure-advisor-actionability

After installing, type/azure-advisor-actionabilityin Claude Code to confirm it loaded.

Details

From the project README

Azure Advisor Actionability

Quick reference

Present remediation for the customer to run; never execute without explicit confirmation. Require the recommendationTypeId GUID and complete affected resourceId; reuse known values, ask for missing values, never guess.

Get resourceId from the user or an exact advisor_recommendation_list affected-resource record. Ask which resource if ambiguous; never use a recommendation instance ID.

Workflow

  1. Call advisor_remediation_get once with only recommendationTypeId, never resourceId, before generating guidance or substituting values.
  2. For RemediationNotFound, empty responses, or no usable remediation, state that Advisor remediation is unavailable. Retrieve relevant public Microsoft Learn documentation; ask for the recommendation description if unknown. If none is available, say so; never invent guidance. Report other tool errors without internals, not as empty results.
  3. Use only returned remediation or retrieved Learn guidance, including warnings and verification.
  4. After retrieval, substitute unambiguous placeholders from the exact affected resourceId or confirmed context: subscription, resource group, resource names, full resource ID. Preserve and describe unresolved placeholders.
  5. Preserve step order; separate Azure CLI and PowerShell.

For Advisor guidance, do not generate commands. For hybrid or executable, include every manual, decision, and command step. Omit raw JSON and internal labels.

Final response

Label the source: "Guidance source: Azure Advisor remediation tool" or "Guidance source: publicly available Microsoft Learn documentation" with retrieved learn.microsoft.com citations. Never attribute fallback guidance to Advisor or claim execution.

Comments

Markdown supported