Skip to content
cccskills
Official · MicrosoftFreePublished on GitHub

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

The English summary is being prepared. Showing the original description.

microsoft/skills
Works withAzureKubernetes
See how to install

Files included (68)

  • SKILL.md6.6 KB
  • deploy/references/approval-gate-template.md2.9 KB
  • deploy/references/blocked-patterns.md5.7 KB
  • deploy/references/code-deployment-appservice.md4.6 KB
  • deploy/references/code-deployment-container-apps.md8.4 KB
  • deploy/references/code-deployment-swa.md5.7 KB
  • deploy/references/database-post-deploy.md4.5 KB
  • deploy/references/deploy-checklist-template.md10.1 KB
  • deploy/references/deploy-safety.md4.5 KB
  • deploy/references/deploy-schemas.ts3.5 KB
  • deploy/references/error-classification.md3.6 KB
  • deploy/references/health-check-patterns.md5.5 KB
  • deploy/references/mcp-tools.md5.5 KB
  • deploy/references/portal-links.md3.1 KB
  • deploy/references/preflight-checks.md4.4 KB
  • deploy/references/subagent-preflight.md5.1 KB
  • deploy/SKILL.md7.5 KB
  • prepare/references/deploy-strategy.md6.8 KB
  • prepare/references/mcp-tools.md5.6 KB
  • prepare/references/naming-patterns.md4.6 KB
  • prepare/references/prepare-schemas.ts7.0 KB
  • prepare/references/pricing-guide-services.md8.4 KB
  • prepare/references/pricing-guide.md4.0 KB
  • prepare/references/service-mapping.md8.5 KB
  • prepare/references/sku-matrix.md3.2 KB
  • prepare/references/sku-quota-validation.md9.0 KB
  • prepare/references/subagent-pricing.md2.5 KB
  • prepare/references/subagent-quota.md3.5 KB
  • prepare/references/validation-rubric.md2.3 KB
  • prepare/SKILL.md6.4 KB
  • references/approval-gates.md7.4 KB
  • references/azd-template-routing.md4.7 KB
  • references/handoff-protocol.md7.8 KB
  • references/iac-resources.md2.6 KB
  • references/intent-gathering.md2.2 KB
  • references/mcp-tool-reference.md3.7 KB
  • references/pipeline-rules-runtime.md3.5 KB
  • references/pipeline-rules.md6.3 KB
  • references/session-protocol.md8.0 KB
  • references/session-schemas.ts5.2 KB
  • references/subscription-resolution.md2.1 KB
  • scaffold/references/bicep-app-service.md5.2 KB
  • scaffold/references/bicep-container-apps.md9.3 KB
  • scaffold/references/bicep-patterns-data.md4.0 KB
  • scaffold/references/bicep-patterns-security.md7.8 KB
  • scaffold/references/bicep-patterns.md6.8 KB
  • scaffold/references/bicep-swa.md757 B
  • scaffold/references/cicd-pipelines.md325 B
  • scaffold/references/dockerfile-generation.md3.8 KB
  • scaffold/references/env-var-secrets.md4.1 KB
  • scaffold/references/error-handling.md1.5 KB
  • scaffold/references/iac-generation-rules.md6.6 KB
  • scaffold/references/mcp-tools.md7.0 KB
  • scaffold/references/rbac-roles.md3.8 KB
  • scaffold/references/scaffold-healing-rules.md3.3 KB
  • scaffold/references/scaffold-schemas.ts3.5 KB
  • scaffold/references/self-healing.md2.3 KB
  • scaffold/references/self-review-checklist.md9.0 KB
  • scaffold/references/self-review-procedure.md2.3 KB
  • scaffold/references/subagent-iac-gen.md9.5 KB
  • scaffold/references/subagent-review.md3.5 KB
  • scaffold/references/subagent-validate.md7.2 KB
  • scaffold/references/terraform-patterns.md6.9 KB
  • scaffold/references/validation-and-manifest.md5.1 KB
  • scaffold/references/waf-checklist.md2.3 KB
  • scaffold/scripts/scaffold-conformance.ps112.8 KB
  • scaffold/scripts/scaffold-conformance.sh13.8 KB
  • scaffold/SKILL.md14.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Azure App Onboard

⛔ Every repo goes through the full pipeline (Steps 1–10). No exceptions. Do not skip steps, refuse, or short-circuit based on what you recognize. Follow the Workflow table below sequentially — read each step's references before acting.

Quick Reference

PropertyValue
Best forDevelopers who know what to build but not which Azure services to use
InputsBusiness idea or existing codebase, budget/scale preferences (optional)
OutputsArchitecture plan, cost estimate, IaC files, deployed Azure resources
PhasesDiscover → Architect → Scaffold → Deploy (self-contained, no external skill calls)

When to Use This Skill

  • Deploy existing code without knowing which Azure services to use
  • Check if your existing code is ready to deploy to Azure
  • Move an existing app to Azure without rewriting or with minimal changes
  • Get cost estimates before committing to infrastructure
  • Understand architecture decisions and rejected alternatives
  • Get answers to Azure architecture or service selection questions (e.g., "What database should I use?")
  • Get guided Azure onboarding without prior experience

When NOT to Use

ScenarioUse Instead
Run azd up or execute an existing deploymentazure-deploy
Optimize existing Azure spendcost-optimization from the optional azure-cost plugin
Generate Bicep/Terraform for a known architectureazure-prepare
Validate infrastructure or run preflight checksazure-validate
Troubleshoot a running Azure deploymentazure-diagnostics
Deploy to or manage AKS/Kubernetes directlyazure-kubernetes
Look up or list existing Azure resourcesazure-resource-lookup

If cost-optimization is unavailable, explain that it is provided by the optional azure-cost plugin and direct the user to their client's supported plugin installation flow; do not imply the handoff completed.

Pipeline Rules

⛔ You MUST read references/pipeline-rules.md at the start of every AppOnboard session. It contains approval gates, phase lifecycle, session artifacts, deploy-as-is, and security baseline rules.

Workflow

⛔ Deploy recovery: After deploy gate approval OR before any az deployment/az webapp deploy/az acr build — if you haven't read deploy/SKILL.md, read .copilot-azure/sessions/{id}/deploy-checklist.md first, then deploy/SKILL.md. ⛔ NEVER invoke {"skill": "azure-deploy"} — that is a DIFFERENT skill for a DIFFERENT workflow.

⛔ Post-scaffold transition (MANDATORY): Immediately after scaffold-manifest.json is written, YOUR NEXT ACTION MUST be Step 8 (Deploy Approval Gate) — NOT a summary report, NOT a "here are the generated files" message, NOT a completion signal. Confirm context.json has completedPhases: [...,"scaffold"] + currentPhase: "deploy" (update it yourself if the scaffold subagent didn't). Re-read approval-gates.md § Deploy Gate if evicted from context (scaffold reference loading is heavy), then present the exact prompt: "🚀 Ready to deploy? (Yes / Run manually / Edit plan / Cancel)". This gate is the LAST content in your response — wait for the user's reply.

#StepActionReference
1Session check + Azure loginCreate/resume session, verify Azure CLI auth, resolve subscription + user identity⛔ You MUST read session-protocol.md
2Scope triageCheck azd markers, triage question. Empty workspace or code-only (no infra) → Step 3 directly.⛔ Read intent-gathering.md § Scope Triage
3Prereq scan⛔ Skip if completedPhases includes "prereq". Otherwise: invoke {"skill": "azure-app-onboard-prereq"}. Write prereq-output.json, update context.json. Halt if: overallHealth: "blocked" OR routeToSkill set.
4Gather intentPresent prereq results, confirm stack + Azure services, ask remaining questions.⛔ Read intent-gathering.md § After Prereq Returns
5Plan architectureWrite prepare-plan.json.⛔ You MUST read prepare/SKILL.md
6Scaffold approval gateDisplay plan for user approval BEFORE generating any files.⛔ Read approval-gates.md § Scaffold Gate
7ScaffoldGenerate IaC, self-review. Write scaffold-manifest.json. Update context.json.⛔ You MUST read scaffold/SKILL.md
8Deploy approval gateDisplay validation summary. ⛔ After approval: FIRST read deploy-checklist.md → deploy/SKILL.md. NEVER {"skill": "azure-deploy"}.⛔ Read approval-gates.md § Deploy Gate
9DeployExecute IaC, health-check. Write deploy-result.json.⛔ You MUST read deploy/SKILL.md
10HandoffSurface deployment identity, cleanup commands, next steps.⛔ You MUST read handoff-protocol.md

Error Handling

ErrorRemediation
Phase failsHalt, report phase + error. User decides: retry, skip, abort.
MCP server unavailableSkip affected checks, add disclaimer to costEstimate.assumptions[] and every approval gate.
Missing RBACReport required role + az role assignment command.

Shared references: MCP tools (cross-phase tool parameters) | IaC resources (Azure resource docs for troubleshooting)

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

agent-framework-azure-ai-py

Official · MicrosoftFree

Build Azure AI Foundry agents using the Microsoft Agent Framework Python SDK (agent-framework-azure-ai). Use when creating persistent agents with AzureAIAgentsProvider, using hosted tools (code interpreter, file search, web search), integrating MCP servers, managing conversation threads, or implementing streaming responses. Covers function tools, structured outputs, and multi-tool agents.

The English summary is being prepared. Showing the original description.

microsoft/skills3.1KUpdated Oct 21, 2026

airunway-aks-setup

Official · MicrosoftFree

Set up AI Runway on AKS — from bare cluster to running model. Covers cluster verification, controller install, GPU assessment, provider setup, and first deployment. WHEN: "setup AI Runway", "onboard AKS cluster", "install AI Runway", "airunway setup", "deploy model to AKS", "GPU inference on AKS", "KAITO setup on AKS", "run LLM on AKS", "vLLM on AKS", "set up model serving on AKS", "AI Runway controller".

The English summary is being prepared. Showing the original description.

microsoft/skills3.1KUpdated Oct 21, 2026

aks-gpu-inference

Official · MicrosoftFree

Diagnose Day-2 AKS GPU and KAITO incidents using profile-aware, read-only evidence. WHEN: 'Insufficient nvidia.com/gpu', GPU pod Pending, model-load OOM, DCGM/VRAM, KAITO Workspace not ready, or GPU autoscaling. DO NOT USE FOR: setup (airunway-aks-setup), non-GPU incidents (aks-troubleshooting), standalone VM quota (azure-quotas), or generic cost (cost-analysis or cost-optimization from the optional azure-cost plugin).

The English summary is being prepared. Showing the original description.

microsoft/skills3.1KUpdated Oct 21, 2026

aks-known-issues

Official · MicrosoftFree

Lookup documented AKS fixes only when the prompt includes an exact catalog signature and all of its qualifiers: VMCannotFitEphemeralOSDisk; NodePoolMcVersionIncompatible; 'NodeImageVersion is not accepted'; AKS SkuNotAvailable with size, location, and zone; ZonalAllocationFailed with insufficient zone capacity; OverconstrainedAllocationRequest with listed constraints; nested AKS vmssCSE/CSE VMExtensionError_OutboundConnFail, VMExtensionError_K8SAPIServerConnFail, or VMExtensionError_K8SAPIServerDNSLookupFail; or AllocationFailed with the full cataloged internal-error or insufficient-regional-capacity message. Never use for quota errors, code-only or bare wrappers, generic symptoms, incomplete signatures, or failures outside AKS; use aks-troubleshooting or azure-diagnostics.

The English summary is being prepared. Showing the original description.

microsoft/skills3.1KUpdated Oct 21, 2026

aks-network-capture

Official · MicrosoftFree

Collects bounded packet captures from AKS nodes and Azure network configuration for wire-level evidence. WHEN: "capture packets on an AKS node", "take a pcap", "run tcpdump on AKS", "prove where packets drop". Use for explicit packet-capture intent after read-only diagnostics, not general AKS connectivity or ingress troubleshooting.

The English summary is being prepared. Showing the original description.

microsoft/skills3.1KUpdated Oct 21, 2026

aks-troubleshooting

Official · MicrosoftFree

Debug live Azure Kubernetes Service (AKS) incidents with a read-only, evidence-first investigation. WHEN: pod crashes or Pending, CrashLoopBackOff, OOMKilled, ImagePullBackOff, node NotReady, DNS or ingress failure, connectivity timeout, network policy, SNAT exhaustion, node-pool scaling blocked by QuotaExceeded or InsufficientVCPUQuota, upgrade stuck, spot or zone disruption, a bare VMExtensionProvisioningError or AllocationFailed wrapper, an uncataloged capacity symptom, or 'investigate my AKS cluster'. DO NOT USE FOR: packet capture (use aks-network-capture); GPU or model-serving issues (use aks-gpu-inference); cluster creation or provisioning (use azure-kubernetes); cost (use cost-analysis from the optional azure-cost plugin); pod rightsizing (use azure-kubernetes); a fully qualified documented AKS signature with every required nested qualifier (use aks-known-issues); standalone failures on non-AKS Azure resources (use azure-diagnostics). Unqualified errors and open-ended incidents stay here only for AKS.

The English summary is being prepared. Showing the original description.

microsoft/skills3.1KUpdated Oct 21, 2026

See all skills by microsoft

Report a problem with this skill