CtrlK
BlogDocsLog inGet started
Tessl Logo

azure-deploy

**WORKFLOW SKILL** — Execute Azure deployments (azd up, azd deploy, terraform apply) for already-prepared apps with built-in error recovery. WHEN: 'run azd up', 'run azd deploy', 'push to production', 'go live', 'bicep deploy', 'terraform apply', 'publish to Azure'. DO NOT USE FOR: creating new apps (azure-prepare), pre-deploy checks (azure-validate).

70

Quality

85%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is an excellent skill description that hits all the marks. It provides specific concrete actions, comprehensive natural trigger terms, explicit 'when to use' and 'when not to use' guidance, and clear differentiation from related skills. The 'DO NOT USE FOR' clause with references to sibling skills is a particularly strong pattern for reducing conflict risk.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'azd up', 'azd deploy', 'terraform apply', and mentions 'built-in error recovery'. Also specifies the precondition 'already-prepared apps', which adds clarity about scope.

3 / 3

Completeness

Clearly answers both 'what' (execute Azure deployments with error recovery) and 'when' (explicit WHEN clause with trigger phrases). Additionally includes a 'DO NOT USE FOR' clause that further clarifies boundaries, which is excellent for disambiguation.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would say: 'run azd up', 'run azd deploy', 'push to production', 'go live', 'bicep deploy', 'terraform apply', 'publish to Azure'. These are highly natural phrases a user would type.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with clear boundaries. Explicitly names sibling skills to avoid conflicts ('azure-prepare' for creating new apps, 'azure-validate' for pre-deploy checks), and the trigger terms are specific to deployment execution rather than general Azure work.

3 / 3

Total

12

/

12

Passed

Implementation

70%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured workflow skill with excellent progressive disclosure and clear step sequencing with validation checkpoints. Its main weaknesses are redundancy (the validation/plan status rules are repeated 3-4 times across different sections) and limited standalone actionability since all concrete commands are delegated to reference files. The skill would benefit from trimming repeated warnings and including at least one concrete command example inline.

Suggestions

Consolidate the repeated validation proof/plan status warnings — they appear in Steps, the callout block, and Gotchas. State the rule once prominently and reference it elsewhere.

Include at least one concrete executable command example inline (e.g., a basic `azd up` invocation) so the skill has standalone actionability without requiring recipe file loading.

DimensionReasoningScore

Conciseness

The skill is mostly efficient but has notable redundancy — the validation proof check is stated in the Steps table (Step 1), then repeated as a callout block, and again in Gotchas (4 separate bullet points essentially restating the same prerequisite chain rules). The Reference Index table at the end partially duplicates links already provided inline. However, it avoids explaining basic concepts Claude would know.

2 / 3

Actionability

The skill provides a clear step sequence and references to external files for concrete commands, but the SKILL.md itself contains no executable code or specific commands — it delegates everything to recipe files and reference docs. The MCP tools table and SDK references are helpful but the actual deployment execution details are absent from this file, making it incomplete on its own.

2 / 3

Workflow Clarity

The workflow is clearly sequenced with numbered steps, explicit validation gates (plan status check, validation proof check), an auto-prepare gate for missing prerequisites, error handling step, and a verification step. The prerequisite chain is enforced at multiple points with clear feedback loops (if not validated → invoke azure-validate first).

3 / 3

Progressive Disclosure

Content is well-structured as an overview with clear one-level-deep references to recipes, checklists, SDK docs, and troubleshooting. The Reference Index table with 'When to Load' guidance and the explicit instruction 'Load these on demand — do NOT read all at once' demonstrate excellent progressive disclosure design.

3 / 3

Total

10

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
jonathan-vella/azure-agentic-infraops
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.