CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

azure-upgrade

Assess and upgrade Azure workloads between plans, tiers, or SKUs, or modernize Azure SDK dependencies in source code. WHEN: upgrade Consumption to Flex Consumption, upgrade Azure Functions plan, change hosting plan, function app SKU, migrate App Service to Container Apps, modernize legacy Azure Java SDKs (com.microsoft.azure to com.azure), migrate Azure Cache for Redis (ACR/ACRE) to Azure Managed Redis (AMR).

Quality

82%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-built orchestration skill: clear sequenced workflow with explicit validation and destructive-action gates, concrete tooling and naming guidance, and clean progressive disclosure into a real, well-organized bundle. The main weaknesses are mild duplication between the description, trigger table, and references list, and the deferral of feedback-loop detail to scenario files.

Suggestions

Trim duplication: the Triggers table restates the description's WHEN clause and the Upgrade Scenarios table is repeated in References — consolidate into one routing table to save tokens.

Add a one-line error-recovery expectation at step 5 (e.g. 'on validation failure, fix and re-validate before proceeding') so the feedback loop is visible at the top level rather than only inside scenario references.

Move the Functions platform-routing blockquote and Redis sub-routing detail into their scenario references, keeping SKILL.md to the routing table plus the fallback rule.

DimensionReasoningScore

Conciseness

The body is dense and operational — tables of triggers, scenarios, and MCP tools with no explanation of concepts Claude already knows — and it assumes competence throughout ('Load the scenario reference and follow its rules'). Not a 5 due to duplication: the Triggers table restates the description's WHEN clause, the Upgrade Scenarios table is repeated in References, and the Next section repeats step 7's hand-off.

4 / 5

Actionability

Gives concrete, executable orchestration guidance: named MCP tools (`mcp_azure_mcp_get_azure_bestpractices`, `mcp_azure_mcp_documentation`), a real command (`az functionapp flex-migration list`), a default naming convention (`<source>-flex`), a status-file path, and explicit ask_user gating semantics. Not a 5 because the actual executable migration steps are delegated to scenario references rather than shown, which is an acceptable pattern but leaves the top-level file as routing rather than copy-paste-ready instruction.

4 / 5

Workflow Clarity

The 7-step sequence is clearly ordered with explicit validation (step 5 defines the checks and the deferred-validation rule) and destructive-operation checkpoints (rules 8, 9, and the ask_user gate), so the destructive-operations cap does not apply. Not a 5 because error-recovery/feedback loops (validate → fix → retry) are not described at the top level — they are deferred to the scenario references — and per-step exit criteria are only implicit.

4 / 5

Progressive Disclosure

Well-structured overview that routes each scenario to a real, existing bundle file (verified: both platform workflow.md files, redis-to-amr.md, java README and templates all exist), with an organized References tree and clear signals for the distinct SDK-modernization flow and the no-match fallback. Not a 5 because routing detail like the Functions platform-routing blockquote and the multi-row Redis routing belong in a reference file, and a few referenced paths (e.g. java INSTRUCTION.md, workflow phases) are only discoverable by reading deeper files rather than from SKILL.md itself.

4 / 5

Total

16

/

20

Passed

Description

83%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: concrete capability statement, third-person voice, and an explicit WHEN clause with specific, natural trigger phrases covering all supported scenarios. The only gaps are a few natural trigger variations that live in the body rather than the description, and no in-description boundary statement against neighboring Azure skills.

DimensionReasoningScore

Specificity

Lists several concrete actions ('Assess and upgrade Azure workloads between plans, tiers, or SKUs', 'modernize Azure SDK dependencies in source code') plus concrete scenarios like 'migrate App Service to Container Apps' and 'migrate Azure Cache for Redis (ACR/ACRE) to Azure Managed Redis (AMR)'. Not a 5 because the action verbs themselves (assess, upgrade, modernize) stay somewhat general and coverage of the assessment/validation side is lighter than the enumeration of scenarios.

4 / 5

Completeness

Explicitly answers both questions: the 'what' ('Assess and upgrade Azure workloads between plans, tiers, or SKUs, or modernize Azure SDK dependencies') and the 'when' via an explicit 'WHEN:' clause with concrete trigger phrases. Matches the score-5 anchor pattern of capability list followed by explicit use-when triggers.

5 / 5

Trigger Term Quality

Strong natural phrasing users would actually say: 'upgrade Consumption to Flex Consumption', 'upgrade Azure Functions plan', 'change hosting plan', 'function app SKU', plus acronyms ACR/ACRE and AMR. Not a 5 because a few natural variations are absent from the description itself (e.g. 'modernize my Java SDK', 'com.microsoft.azure to com.azure', 'ready for Flex Consumption' — these appear only in the body's trigger table).

4 / 5

Distinctiveness Conflict Risk

Clear niche (intra-Azure plan/tier/SKU upgrades and Azure SDK modernization) with distinct triggers like 'Consumption to Flex Consumption' and 'ACR to AMR' that few other skills would claim. Not a 5 because the description does not itself state the boundary against related azure-* skills (e.g. cross-cloud migration is only excluded in the body), leaving minor overlap risk with adjacent Azure deployment/validation skills.

4 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 16 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 16 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

microsoft/azure-skills

Path

.github/plugins/azure-skills/skills/azure-upgrade/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.