**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
85%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
05d7617
Table of Contents
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.