CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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).

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

The canonical home for this skill is azure-app-onboard in microsoft/GitHub-Copilot-for-Azure

SKILL.md
Quality
Evals
Security

Quality

Content

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

The workflow is exceptionally well-orchestrated — a sequenced 10-step pipeline with approval gates, halt conditions, state-resume rules, and error feedback loops — and the body is token-efficient with concrete, executable guidance. The main defect is against the actual bundle: the three sub-skill files (prepare, scaffold, deploy) referenced by the core pipeline steps are missing, and four reference files are not discoverable from SKILL.md.

Suggestions

Add the missing prepare/SKILL.md, scaffold/SKILL.md, and deploy/SKILL.md files to the bundle (or correct their paths) — Steps 5, 7, and 9 currently dead-end at references that do not exist.

Surface the four orphaned reference files (azd-template-routing.md, pipeline-rules-runtime.md, session-schemas.ts, subscription-resolution.md) from SKILL.md or from the relevant workflow-step rows so they are discoverable one level deep.

Deduplicate the deploy-recovery instructions, which appear nearly verbatim in both the Workflow preamble and Step 8; state the rule once and reference it.

DimensionReasoningScore

Conciseness

The body is dense and operational — tables, exact file names, and gate prompts with no explanations of concepts Claude already knows. Minor trimming is possible: the deploy-recovery rule ("read deploy-checklist.md first, then deploy/SKILL.md… NEVER invoke azure-deploy") is stated nearly verbatim in both the Workflow preamble and Step 8, and the post-scaffold transition block is wordy. This fits anchor 4 (efficient, minor instances that could be trimmed) rather than 5, where every token would earn its place.

4 / 5

Actionability

Guidance is concrete and executable: exact artifact names ("prereq-output.json", "prepare-plan.json", "scaffold-manifest.json", "deploy-result.json"), exact invocation ("invoke {\"skill\": \"azure-app-onboard-prereq\"}"), exact halt conditions ("overallHealth: 'blocked' OR routeToSkill set"), the literal gate prompt ("🚀 Ready to deploy? (Yes / Run manually / Edit plan / Cancel)"), and a specific "az role assignment" remediation command. Minor gaps: Step 5 gives no schema/location for prepare-plan.json in the body, deferring entirely to a sub-skill file — anchor 4, mostly executable with minor gaps.

4 / 5

Workflow Clarity

A clearly sequenced 10-step pipeline table with explicit validation checkpoints (prereq halt conditions, Scaffold Gate and Deploy Gate user approval before costly/destructive actions, scaffold self-review, deploy health-check), state-resume rules ("Skip if completedPhases includes 'prereq'"), a feedback loop for recovery ("Phase fails → Halt, report… User decides: retry, skip, abort"), and error-handling/remediation tables. This matches anchor 5: clear sequence, explicit validation, feedback loops, checklists.

5 / 5

Progressive Disclosure

The overview structure and clearly signaled references are good, but scoring against the actual bundle reveals broken navigation: three core referenced paths — prepare/SKILL.md, scaffold/SKILL.md, deploy/SKILL.md (Steps 5, 7, and 9) — do not exist in the bundle, dead-ending the pipeline's central phases. Additionally, four bundle files (azd-template-routing.md, pipeline-rules-runtime.md, session-schemas.ts, subscription-resolution.md) are never surfaced from SKILL.md, reachable only via second-level links. That is more than the 'minor organization gaps' of anchor 4, fitting anchor 3 (structure present but could be better organized).

3 / 5

Total

16

/

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 that explicitly states concrete capabilities, provides a rich set of natural trigger phrases, and cleanly fences off sibling skills. The only deductions are the second-person phrasing ("your app") and mild marketing padding, plus a few overly generic triggers that invite minor over-triggering.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "Analyzes your app, auto-detects the right Azure services, scaffolds infrastructure code, and deploys", plus "cost estimates and pre-deploy approval" and migration handling — which matches the anchor-5 example in coverage. However, the second-person voice ("Analyzes your app… tailored to your app") triggers the mandated 1-point specificity penalty, and "End-to-end orchestrator" / "tailored to your app, not a template" is marketing fluff, landing it at anchor 4.

4 / 5

Completeness

Explicitly answers both questions: what ("Analyzes your app, auto-detects the right Azure services, scaffolds infrastructure code, and deploys") and when (an explicit "WHEN:" clause with concrete trigger phrases, plus a "DO NOT USE FOR" exclusion list). This matches the anchor-5 example pattern exactly.

5 / 5

Trigger Term Quality

The WHEN clause covers comprehensive natural phrasings with many synonyms: "bring your app to Azure", "deploy my app to the cloud", "migrate my app to Azure", "what Azure services do I need", "cost to run", "one-click deploy", "no code yet", "starter project". Coverage spans the full intent space (deploy, migrate, plan, cost, greenfield) with no identifiable missing natural terms for this domain.

5 / 5

Distinctiveness Conflict Risk

The niche is clear and closely related skills are explicitly disambiguated ("use azd for deployment(use azure-deploy)", "optimizing existing costs (use cost-optimization)", "code readiness checks only (use azure-app-onboard-prereq)"). Minor overlap risk remains from unqualified generic triggers like "build an app", "help me get started", and "no code yet", which could fire on non-Azure app-building requests.

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/azure-skills

Path

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