CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

azure-deploy

Execute Azure deployments for ALREADY-PREPARED applications that have existing .azure/deployment-plan.md and infrastructure files. DO NOT use this skill when the user asks to CREATE a new application — use azure-prepare instead. This skill runs azd up, azd deploy, terraform apply, and az deployment commands with built-in error recovery. Requires .azure/deployment-plan.md from azure-prepare and validated status from azure-validate. WHEN: "run azd up", "run azd deploy", "execute deployment", "push to production", "push to cloud", "go live", "ship it", "bicep deploy", "terraform apply", "publish to Azure", "launch on Azure". DO NOT USE WHEN: "create and deploy", "build and deploy", "create a new app", "set up infrastructure", "create and deploy to Azure using Terraform" — use azure-prepare for these.

Quality

86%

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

73%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-engineered control-flow hub for a complex deployment skill: excellent workflow sequencing with layered validation gates and genuine progressive disclosure into a 40+ file bundle. The main costs are rhetorical repetition of the prerequisite gate (four restatements plus duplicated failure warnings) and a slightly under-linked recipe chain.

Suggestions

State the azure-prepare/azure-validate prerequisite once (e.g., in the STOP block) and let Step 1 enforce it; currently the same gate is repeated in the intro block, Rules 1-2, and Step 1.

Trim the duplicated failure warnings ("Skipping steps causes deployment failures" and "If you update the status... deployments will fail") to a single consequence statement.

In the Steps table, link Step 7's error handling directly to the recipe errors.md files (e.g., recipes/azd/errors.md) instead of "—", closing the two-hop navigation gap through recipes/README.md.

DimensionReasoningScore

Conciseness

The prerequisite gate is stated four times — the AUTHORITATIVE GUIDANCE block ("azure-validate skill MUST be invoked and completed with status Validated BEFORE executing"), the STOP block, Rules 1-2 ("must exist with status Validated"), and Step 1 — and failure warnings repeat ("Skipping steps causes deployment failures", "deployments will fail"). Mostly efficient (tight tables, lean 88-line body) but the duplicated gating prose could be consolidated into one statement plus the Step 1 check, which fits the 'could be tightened' anchor rather than the 'several padded sections' of score 2.

3 / 5

Actionability

Steps carry concrete, executable specifics where it matters: "run azd provision --no-prompt, then verify AcrPull role has propagated" (Step 4), "verify status = Validated AND Validation Proof section is populated" (Step 1), and the URL-format rule gives an explicit https:// example; every step also names the file that holds the actual commands. It sits between anchors because core deploy execution is fully delegated to the recipe files rather than shown, leaving minor gaps like Step 5's bare "Follow recipe steps".

4 / 5

Workflow Clarity

The 10-step table gives a clear sequence with explicit validation checkpoints at the front (plan status + Validation Proof), middle (RBAC propagation gate before image deploy), and end (verify success, live role verification), plus a dedicated error-handling step routing to each recipe's errors.md and a mandatory pre-deploy checklist. This matches the top anchor: explicit validation steps, feedback loops for error recovery, and a checklist for a complex, partly destructive process.

5 / 5

Progressive Disclosure

The body is a lean overview with well-signaled references, and every referenced path resolves to a real bundle file (including the deep anchor into pre-deploy-checklist.md's RBAC section). It stops short of the 5 anchor because the recipe content chains two hops from the top (SKILL.md → recipes/README.md → azd/README.md → errors.md) and Step 7's reference column is "—" with no direct link to the recipe's errors.md — minor organization gaps rather than the inlining or buried references of score 3.

4 / 5

Total

16

/

20

Passed

Description

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

An exemplary description: concrete command-level capabilities, comprehensive natural trigger phrases, explicit use/don't-use boundaries, and active disambiguation from the sibling azure-prepare skill. Its only weakness is mild repetitiveness (prerequisites restated) and omission of the verification steps it actually performs.

DimensionReasoningScore

Specificity

"This skill runs azd up, azd deploy, terraform apply, and az deployment commands with built-in error recovery" lists several concrete, specific actions with clearly defined inputs ("existing .azure/deployment-plan.md and infrastructure files"). It falls just short of the 5 anchor because post-deployment verification and reporting — actual steps of this skill — are not mentioned, a minor coverage gap.

4 / 5

Completeness

Both questions are explicitly answered: the 'what' ("Execute Azure deployments for ALREADY-PREPARED applications... runs azd up, azd deploy, terraform apply, and az deployment commands") and the 'when' (a concrete WHEN list of trigger phrases), plus an explicit DO NOT USE WHEN list. This squarely fits the anchor for clearly and explicitly answering both what and when with concrete trigger phrases.

5 / 5

Trigger Term Quality

The WHEN clause covers a comprehensive set of natural phrases users would actually say — "push to production", "go live", "ship it", "launch on Azure", "publish to Azure" — alongside precise technical triggers like "run azd up" and "terraform apply". It clearly matches the comprehensive-coverage anchor rather than score 4, since no common synonym or variation is obviously missing.

5 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche (deploying already-prepared apps) and actively resolves the main conflict by stating "DO NOT use this skill when the user asks to CREATE a new application — use azure-prepare instead" with matching anti-triggers ("create and deploy", "build and deploy"). It matches the clear-niche-with-minimal-conflict-risk anchor; the sibling-skill references reduce rather than increase overlap.

5 / 5

Total

19

/

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: 10 deeper-than-1-level

Warning

referenced_paths_exist

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

Warning

Total

14

/

16

Passed

Repository

microsoft/GitHub-Copilot-for-Azure

Path

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