All skills
microsoft avatar

/azure-prepare

@b8a1c66
by microsoftmicrosoft/skills3.1k stars
351

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Terraform), and Dockerfiles for the Azure Developer CLI (azd) workflow. USE ONLY when the user explicitly wants to use azd as the deployment tool, or the project already has an azure.yaml file. DO NOT USE FOR: non-azd deployments, Python App Service code-only deploys (use python-appservice-deploy), or cross-cloud migration (use azure-cloud-migrate). WHEN: prepare app for azd, create azure.yaml, set up azd infrastructure, modernize app for Azure with azd, deploy with azd, function app, timer trigger, service bus trigger, event-driven function, managed identity, generate Bicep, generate Terraform, create and deploy to Azure.

Use this Skill: https://skilld.dev/gh/microsoft/skills/azure-prepare

This session only. Nothing lands on disk.

referencesservicesfunctionstemplatesrecipesmcpREADME.md

≈487 tokens on demand. Your agent reads this file only when SKILL.md points to it.

MCP (Model Context Protocol) Recipe

MCP tool endpoints for AI agent integration via the JSON-RPC 2.0 protocol.

Template Selection

Resource filter: mcp
Discover templates via MCP or CDN manifest where resource == "mcp" and language matches user request.

Protocol

MCP uses the JSON-RPC 2.0 protocol. Two template types with different transport support:

  • Extension-based (mcp-server-remote-*) supports both Streamable HTTP and SSE transports
  • Self-hosted (mcp-sdk-hosting-*) — supports Streamable HTTP only

See MCP Specification for protocol details.

Troubleshooting

Transport Mismatch

Cause: Client and server using different transports — SSE client gets 404/405, HTTP client gets unexpected text/event-stream.
Solution: Extension-based templates support both Streamable HTTP and SSE. Self-hosted templates support Streamable HTTP only. In VS Code mcp.json, set "type": "sse" or "type": "http" to match the server.

Missing App Settings After Deploy

Cause: Required app settings not configured on the function app.
Solution: Ensure protected resource metadata settings are present. For C# self-hosted servers, verify host.json arguments points to the compiled DLL path.

See MCP extension trigger and bindings for extension-based servers, Self-hosted MCP servers for self-hosted architecture, and MCP tutorial troubleshooting for self-hosted deployment issues.

Eval

Path Description
eval/summary.md Evaluation summary
eval/python.md Python evaluation results

Source: SKILL.md on GitHub

2 warnings3d4 checks · Risk SAFE
  • Gen Agent Trust Hub3d

    This skill includes security considerations related to the processing of untrusted project files and the retrieval of external development templates. While these operations are essential for modernizing and preparing Azure applications, they represent a surface area for indirect prompt injection and depend on the integrity of external template repositories.

  • Socket3d

    5 alerts: gptAnomaly, gptSecurity

  • Snyk3d

    Risk: LOW · No issues

  • Runlayer7mo

    86/87 files flagged

Signed by skilld at b8a1c66. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated last week
metadata
{
  "author": "Microsoft",
  "version": "1.3.4"
}

README badge

README badge for microsoft/skills/azure-prepare