CtrlK
BlogDocsLog inGet started
Tessl Logo

azure-app-onboard

End-to-end orchestrator: from a business idea, app idea, or existing app to running Azure deployment with cost estimates and pre-deploy approval. Analyzes your app, auto-detects the right Azure services, scaffolds infrastructure code, and deploys — tailored to your app, not a template. Handles moving existing apps to Azure without rewriting or with minimal changes. WHEN: bring your app to Azure, plan my app, cost to run, is my code ready to deploy, deploy my app to the cloud, deploy all my services, what Azure services do I need, plan my Azure deployment, deploy my new app to Azure, one-click deploy, I have an app and want it on Azure, migrate my app to Azure, help me get started, build an app, no code yet, starter project. DO NOT USE FOR: use azd for deployment(use azure-deploy), optimizing existing costs (use cost-optimization), code readiness checks only (use azure-app-onboard-prereq).

72

Quality

91%

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

88%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 tightly written orchestrator body with a clearly sequenced, well-gated pipeline and highly concrete operational instructions. Its main weaknesses are repeated warning text and references to three sub-skill files that are not present in the bundle.

Suggestions

Ship or fix the prepare/SKILL.md, scaffold/SKILL.md, and deploy/SKILL.md references — three MUST READ steps currently point to files missing from the bundle.

State the 'NEVER invoke azure-deploy' rule once (e.g., in the deploy-recovery note) and reference it from Steps 3/8 instead of repeating it three times.

DimensionReasoningScore

Conciseness

The body is dense and operational (tables for steps, when/when-not, and error handling) with no concept explanations Claude already knows, matching 'efficient'. Minor trimmable redundancy: the 'NEVER invoke {"skill": "azure-deploy"}' rule is stated three times (deploy-recovery note, Step 8, Workflow header note), and the Post-scaffold transition paragraph is wordy — this keeps it below the 'every token earns its place' anchor.

4 / 5

Actionability

Fully concrete instruction-level guidance: named session artifacts (prereq-output.json, prepare-plan.json, scaffold-manifest.json, deploy-result.json), exact skill invocations ('{"skill": "azure-app-onboard-prereq"}'), machine-checkable halt conditions ('overallHealth: "blocked" OR routeToSkill set'), the exact approval prompt text, and per-step required file reads — copy-paste-ready operational direction covering the common cases.

5 / 5

Workflow Clarity

A 10-step sequenced pipeline with explicit validation checkpoints (Scaffold Gate before generating files, Deploy Gate before any deployment, self-review in Step 7, health-check in Step 9), explicit halt conditions, a checklist (deploy-checklist.md), and an error-handling table with a retry/skip/abort feedback loop — matching the level-5 anchor for destructive/batch operations.

5 / 5

Progressive Disclosure

Good structure with clearly signaled, one-level-deep references that all exist in references/ (pipeline-rules.md, session-protocol.md, intent-gathering.md, approval-gates.md, handoff-protocol.md, mcp-tool-reference.md, iac-resources.md), matching the 'mostly clear, minor organization gaps' anchor. The gap: 'prepare/SKILL.md', 'scaffold/SKILL.md', and 'deploy/SKILL.md' are marked MUST READ in Steps 5/7/9 but are absent from the bundle, leaving broken navigation for three core steps.

4 / 5

Total

18

/

20

Passed

Description

91%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 with comprehensive natural trigger phrases, explicit what/when guidance, and clear redirects away from sibling skills. Its only deductions are the second-person phrasing and a few overly broad trigger terms that could over-trigger.

Suggestions

Rewrite in third person ('Analyzes the user's app', 'tailored to each app') to match the required voice and recover the specificity penalty.

Trim generic catch-all triggers ('help me get started', 'build an app', 'starter project') or qualify them with Azure context to reduce false-trigger risk against general app-building skills.

DimensionReasoningScore

Specificity

Lists multiple concrete actions covering the full pipeline ('Analyzes your app, auto-detects the right Azure services, scaffolds infrastructure code, and deploys', 'cost estimates and pre-deploy approval', 'moving existing apps to Azure without rewriting'), which matches the level-5 anchor. However, the description uses second-person voice ('Analyzes your app', 'tailored to your app'), which per the judging guidelines reduces the specificity score by 1.

4 / 5

Completeness

Explicitly answers both 'what' (orchestrator from idea/existing app to running Azure deployment with analysis, service detection, scaffolding, and deploy) and 'when' (a dedicated 'WHEN:' clause with concrete trigger phrases), plus a 'DO NOT USE FOR' clause with redirects — matching the level-5 anchor exactly.

5 / 5

Trigger Term Quality

The 'WHEN:' clause lists ~16 natural phrases users would actually say, including synonyms and variations ('deploy my app to the cloud', 'deploy my new app to Azure', 'one-click deploy', 'migrate my app to Azure', 'cost to run', 'no code yet'), matching the comprehensive-coverage anchor.

5 / 5

Distinctiveness Conflict Risk

A 'DO NOT USE FOR' clause explicitly disambiguates the closest siblings ('use azd for deployment (use azure-deploy)', 'optimizing existing costs (use cost-optimization)', 'code readiness checks only (use azure-app-onboard-prereq)'), giving a clear niche. Broad catch-all triggers like 'help me get started', 'build an app', and 'starter project' create minor overlap risk with general app-building skills, so it fits the 'mostly distinct; minor overlap risk' anchor rather than level 5.

4 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 3 missing

Warning

Total

15

/

16

Passed

Repository
microsoft/GitHub-Copilot-for-Azure
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.