[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M73A77CHP96HBGD6G7FQE2GR":3,"skill-same:01M73A77CHP96HBGD6G7FQE2GR":68},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":16,"sourceHtmlUrl":17,"categories":18,"keywords":19,"publishedAt":20,"linkOnly":21,"markdownContent":22,"markdownBody":23,"frontMatter":24,"refName":33,"commitSha":34,"skillDirectory":35,"forksCount":36,"repositoryHtmlUrl":37,"repositoryHomepageUrl":38,"ownerHtmlUrl":39,"ownerBlogUrl":40,"ownerDescription":41,"updatedAt":42,"install":43,"resources":56},"01M73A77CHP96HBGD6G7FQE2GR","azure-integrations",null,"Azure deployment for web apps — Static Web Apps, App Service, Blob Storage, Bicep\u002FARM, GitHub Actions CI\u002FCD. Use when deploying Next.js\u002FVite to Azure or configuring Azure resources for full-stack apps.","bg-szy\u002FTOP-SKILLS","bg-szy","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F106576190?v=4","01M73A4E8KPV67SFXRY8XZGNBX","ShuZhiyong","01M73A4E96MQ294MHM74TZBVQD",6,"MIT","https:\u002F\u002Fgithub.com\u002Fbg-szy\u002FTOP-SKILLS\u002Fblob\u002Fmaster\u002Fskills\u002Fagent-skills\u002Fazure-integrations\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fbg-szy\u002FTOP-SKILLS\u002Fblob\u002Fmaster\u002Fskills\u002Fagent-skills\u002Fazure-integrations\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: azure-integrations\nversion: \"2.0\"\nlast_updated: 2026-09-08\ntags: [azure, integrations, cloud, architecture, operations]\ndescription: \"Azure deployment for web apps — Static Web Apps, App Service, Blob Storage, Bicep\u002FARM, GitHub Actions CI\u002FCD. Use when deploying Next.js\u002FVite to Azure or configuring Azure resources for full-stack apps.\"\n---\n# Azure Integrations\n\n> Tech Stack Target \u002F Version: Azure Static Web Apps, App Service, Bicep or ARM templates, GitHub Actions, Node.js 20+, and Azure CLI 2.60+.\n\nDeployment and integration patterns for Azure cloud services, focusing on web application hosting, CI\u002FCD automation, and infrastructure as code.\n\n- Leverage native parallel subagent dispatch and 200k+ context windows where available.\n\n\n## When to Use This Skill\n\nUse symptom -> action triggers: when one matches, apply this skill and verify with the protocol below.\n\n- Deploying Next.js or Vite\u002FReact apps to Azure\n- Setting up CI\u002FCD workflows with GitHub Actions\n- Configuring Azure Static Web Apps or App Service\n- Managing Azure Blob Storage for file uploads\n- Using Azure Key Vault for secure secrets management\n- Setting up Application Insights for monitoring\n- Writing Bicep or ARM templates for infrastructure as code\n- Integrating Azure Cosmos DB (MongoDB API) with applications\n\n\u003C!-- MCP:START -->\n\n\u003C!-- PORTABILITY:START -->\n## Cross-Client Portability\n\nThis skill is written to stay usable across GitHub Copilot, Claude Code, and Codex.\n\n- GitHub Copilot: keep the folder in a Copilot-visible skill path or wrap the\n  workflow in project instructions when folder discovery is unavailable.\n- Claude Code: keep the folder in a local skills directory or a compatible plugin source.\n- Codex: install or sync the folder into\n  `$CODEX_HOME\u002Fskills\u002Fazure-integrations` and restart Codex after major changes.\n\n\u003C!-- PORTABILITY:END -->\n\n## MCP Availability And Fallback\n\nPreferred MCP Server: Azure MCP\n\n- Fallback prompt: \"Use the Azure Integrations skill without MCP. Follow the documented local or manual fallback, show the selected tool surface, and report the verification evidence.\"\n- Use Azure CLI (`az`), Bicep or ARM templates, and the bundled PowerShell deployment scripts in this skill when the MCP server is unavailable.\n- Validate resources with `az` queries, deployment logs, and portal checks before closing the task.\n- Do not claim an MCP operation was used when the active host does not expose it.\n\n\u003C!-- MCP:END -->\n\n## Anti-Patterns\n\n- Changing infrastructure before inspecting the current state: Cloud drift and hidden dependencies make blind edits risky.\n- Hardcoding credentials or environment assumptions: Rollouts stop being reproducible and secrets become harder to rotate.\n- Skipping rollback, observability, or validation planning: You only notice the missing safeguards after the deployment is already live.\n\n## Verification Protocol\n\nBefore claiming \"skill applied successfully\":\n\n1. Pass\u002Ffail: The Azure Integrations implementation names the target runtime, framework version, and affected files.\n2. Pass\u002Ffail: Build, lint, test, or equivalent local validation is run for the changed surface.\n3. Pass\u002Ffail: Edge cases for errors, dependency drift, and environment differences are addressed or explicitly out of scope.\n4. Pressure-test scenario: Apply the workflow to a change that passes happy-path tests but fails one boundary condition.\n5. Success metric: Zero untested success claims; every implementation claim maps to a command or artifact.\n\n## Available Deployment Scripts\n\n- **[examples\u002Fvite-swa-deployment.md](.\u002Fexamples\u002Fvite-swa-deployment.md)** - Vite\u002FReact to Static Web Apps\n- **[examples\u002Fnextjs-app-service-deployment.md](.\u002Fexamples\u002Fnextjs-app-service-deployment.md)** - Next.js to App Service with Key Vault, App Insights, Storage\n- **[scripts\u002Fdeploy-swa.ps1](.\u002Fscripts\u002Fdeploy-swa.ps1)** - PowerShell deployment script for SWA\n- **[scripts\u002Fdeploy-appservice.ps1](.\u002Fscripts\u002Fdeploy-appservice.ps1)** - PowerShell deployment script for App Service\n\n## Reference Documentation\n\n- **[references\u002Fbicep-quickref.md](.\u002Freferences\u002Fbicep-quickref.md)** - Bicep template patterns and syntax\n- **[references\u002Fgithub-actions-azure.md](.\u002Freferences\u002Fgithub-actions-azure.md)** - GitHub Actions patterns for Azure deployments\n\n---\n\n## Azure Static Web Apps\n\n### Deployment Setup\n```yaml\n\n\nname: Deploy to Azure Static Web Apps\n\non:\n  push:\n    branches: [main]\n  pull_request:\n    types: [opened, synchronize, reopened, closed]\n    branches: [main]\n\njobs:\n  build_and_deploy:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions\u002Fcheckout@v4\n\n      - name: Build and Deploy\n        uses: Azure\u002Fstatic-web-apps-deploy@v1\n        with:\n          azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_API_TOKEN }}\n          repo_token: ${{ secrets.GITHUB_TOKEN }}\n          action: \"upload\"\n          app_location: \"\u002F\"\n          api_location: \"api\"\n          output_location: \"dist\"\n```\n\n### Configuration (staticwebapp.config.json)\n```json\n{\n  \"routes\": [\n    { \"route\": \"\u002Fapi\u002F*\", \"allowedRoles\": [\"authenticated\"] },\n    { \"route\": \"\u002F*\", \"serve\": \"\u002Findex.html\", \"statusCode\": 200 }\n  ],\n  \"navigationFallback\": {\n    \"rewrite\": \"\u002Findex.html\",\n    \"exclude\": [\"\u002Fapi\u002F*\", \"*.{css,js,png,jpg,svg,ico}\"]\n  },\n  \"globalHeaders\": {\n    \"X-Content-Type-Options\": \"nosniff\",\n    \"X-Frame-Options\": \"DENY\",\n    \"Content-Security-Policy\": \"default-src 'self'\"\n  },\n  \"responseOverrides\": {\n    \"401\": { \"redirect\": \"\u002Flogin\", \"statusCode\": 302 }\n  }\n}\n```\n\n### Best Practices\n- Use staging environments for PR previews\n- Configure custom domains with SSL\n- Set up authentication providers (Azure AD, GitHub, etc.)\n- Use API routes for serverless backend functions\n\n---\n\n## Azure App Service\n\nFull end-to-end deployment guide with **Key Vault integration, Application Insights, and Azure Storage** available in [examples\u002Fnextjs-app-service-deployment.md](.\u002Fexamples\u002Fnextjs-app-service-deployment.md).\n\n### Quick Reference\n| Resource | Purpose |\n|-----------|---------|\n| **App Service Plan** | Linux hosting for Node.js apps |\n| **Web App** | Next.js application instance |\n| **Key Vault** | Secure secrets management (MongoDB URI, auth secrets) |\n| **Storage Account** | File uploads (recipe images) |\n| **Application Insights** | Monitoring and telemetry |\n| **Managed Identity** | Service-to-service authentication (no passwords) |\n\n### PowerShell Deployment Script\nAutomated deployment script: **[scripts\u002Fdeploy-appservice.ps1](.\u002Fscripts\u002Fdeploy-appservice.ps1)**\n```powershell\n.\\deploy-appservice.ps1 -AppName \"my-app\" -ResourceGroup \"rg-my-app\" -Sku S1 -EnableAppInsights -EnableStorage\n```\n\n### Deployment Workflow\n```yaml\n\n\nname: Deploy Next.js to App Service\n\non:\n  push:\n    branches: [main]\n\npermissions:\n  id-token: write   # Required for OIDC authentication\n\njobs:\n  build-and-deploy:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions\u002Fcheckout@v4\n\n      - name: Setup Node.js\n        uses: actions\u002Fsetup-node@v4\n        with:\n          node-version: '20'\n          cache: 'npm'\n\n      - name: Install and Build\n        run: |\n          npm ci\n          npm run build\n\n      - name: Azure Login (OIDC)\n        uses: azure\u002Flogin@v2\n        with:\n          client-id: ${{ secrets.AZURE_CLIENT_ID }}\n          tenant-id: ${{ secrets.AZURE_TENANT_ID }}\n          subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}\n\n      - name: Deploy to App Service\n        uses: azure\u002Fwebapps-deploy@v3\n        with:\n          app-name: kitchen-odyssey\n          package: .\n```\n\n### Key Features Covered in Full Guide\n- ✅ Zero-downtime deployments with deployment slots\n- ✅ Key Vault integration for secure secrets\n- ✅ Managed Identity authentication (no secrets in app settings)\n- ✅ Application Insights for monitoring and telemetry\n- ✅ Azure Storage for file uploads with CORS\n- ✅ Bicep infrastructure as code templates\n- ✅ Production-ready security headers\n- ✅ Automated CI\u002FCD with GitHub Actions\n\n### App Settings (Key Vault Pattern)\n```bash\n\n\naz webapp config appsettings set --name \u003Capp-name> --resource-group \u003Crg> --settings \\\n  AZURE_KEYVAULT_RESOURCEENDPOINT=\"https:\u002F\u002F\u003Cvault-name>.vault.azure.net\" \\\n  AZURE_CLIENTID=\"\u003CManaged-Identity-Client-ID>\" \\\n  NEXTAUTH_URL=\"https:\u002F\u002F\u003Capp-name>.azurewebsites.net\" \\\n  NODE_ENV=\"production\"\n```\n\n**Legacy Pattern (not recommended - secrets exposed in app settings):**\n```bash\n\n\naz webapp config appsettings set --name \u003Capp-name> --resource-group \u003Crg> --settings \\\n  MONGODB_URI=\"mongodb+srv:\u002F\u002F...\" \\\n  NEXTAUTH_SECRET=\"...\"\n```\n\n\n---\n\n## Azure Blob Storage\n\n### Upload Integration\n```javascript\nimport { BlobServiceClient } from '@azure\u002Fstorage-blob';\n\nconst blobServiceClient = BlobServiceClient.fromConnectionString(\n  process.env.AZURE_STORAGE_CONNECTION_STRING\n);\n\nexport async function uploadFile(containerName, fileName, buffer, contentType) {\n  const containerClient = blobServiceClient.getContainerClient(containerName);\n  await containerClient.createIfNotExists({ access: 'blob' });\n\n  const blockBlobClient = containerClient.getBlockBlobClient(fileName);\n  await blockBlobClient.uploadData(buffer, {\n    blobHTTPHeaders: { blobContentType: contentType },\n  });\n\n  return blockBlobClient.url;\n}\n\nexport async function deleteFile(containerName, fileName) {\n  const containerClient = blobServiceClient.getContainerClient(containerName);\n  const blockBlobClient = containerClient.getBlockBlobClient(fileName);\n  await blockBlobClient.deleteIfExists();\n}\n\nexport async function generateSasUrl(containerName, fileName, expiresInMinutes = 60) {\n  const containerClient = blobServiceClient.getContainerClient(containerName);\n  const blobClient = containerClient.getBlobClient(fileName);\n\n  const sasUrl = await blobClient.generateSasUrl({\n    permissions: BlobSASPermissions.parse('r'),\n    expiresOn: new Date(Date.now() + expiresInMinutes * 60 * 1000),\n  });\n\n  return sasUrl;\n}\n```\n\n---\n\n## Bicep Templates\n\n### Web App + Cosmos DB\n```bicep\n@description('The name of the web app')\nparam appName string\n\n@description('The location for resources')\nparam location string = resourceGroup().location\n\n@description('The SKU of the App Service Plan')\nparam sku string = 'B1'\n\nresource appServicePlan 'Microsoft.Web\u002Fserverfarms@2023-01-01' = {\n  name: '${appName}-plan'\n  location: location\n  sku: {\n    name: sku\n  }\n  properties: {\n    reserved: true\n  }\n  kind: 'linux'\n}\n\nresource webApp 'Microsoft.Web\u002Fsites@2023-01-01' = {\n  name: appName\n  location: location\n  properties: {\n    serverFarmId: appServicePlan.id\n    siteConfig: {\n      linuxFxVersion: 'NODE|20-lts'\n      appSettings: [\n        { name: 'MONGODB_URI', value: cosmosDb.listConnectionStrings().connectionStrings[0].connectionString }\n        { name: 'NODE_ENV', value: 'production' }\n      ]\n    }\n  }\n}\n\nresource cosmosDb 'Microsoft.DocumentDB\u002FdatabaseAccounts@2023-04-15' = {\n  name: '${appName}-db'\n  location: location\n  kind: 'MongoDB'\n  properties: {\n    databaseAccountOfferType: 'Standard'\n    capabilities: [{ name: 'EnableMongo' }]\n    locations: [{ locationName: location, failoverPriority: 0 }]\n  }\n}\n\noutput webAppUrl string = 'https:\u002F\u002F${webApp.properties.defaultHostName}'\n```\n\n### Deployment\n```bash\naz deployment group create \\\n  --resource-group myResourceGroup \\\n  --template-file main.bicep \\\n  --parameters appName=my-recipe-app\n```\n\n---\n\n## GitHub Actions CI\u002FCD Patterns\n\n### Multi-Environment Pipeline\n```yaml\nname: CI\u002FCD Pipeline\n\non:\n  push:\n    branches: [main, staging]\n  pull_request:\n    branches: [main]\n\njobs:\n  test:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions\u002Fcheckout@v4\n      - uses: actions\u002Fsetup-node@v4\n        with: { node-version: '20', cache: 'npm' }\n      - run: npm ci\n      - run: npm run lint\n      - run: npm run test\n\n  deploy-staging:\n    needs: test\n    if: github.ref == 'refs\u002Fheads\u002Fstaging'\n    runs-on: ubuntu-latest\n    environment: staging\n    steps:\n      - uses: actions\u002Fcheckout@v4\n      - run: npm ci && npm run build\n      - uses: azure\u002Fwebapps-deploy@v3\n        with:\n          app-name: ${{ secrets.STAGING_APP_NAME }}\n          publish-profile: ${{ secrets.STAGING_PUBLISH_PROFILE }}\n\n  deploy-production:\n    needs: test\n    if: github.ref == 'refs\u002Fheads\u002Fmain'\n    runs-on: ubuntu-latest\n    environment: production\n    steps:\n      - uses: actions\u002Fcheckout@v4\n      - run: npm ci && npm run build\n      - uses: azure\u002Fwebapps-deploy@v3\n        with:\n          app-name: ${{ secrets.PROD_APP_NAME }}\n          publish-profile: ${{ secrets.PROD_PUBLISH_PROFILE }}\n```\n\n---\n\n## Troubleshooting\n\n| Issue | Solution |\n|-------|----------|\n| SWA deployment fails | Check `output_location` matches build output directory |\n| App Service 500 errors | Check application logs: `az webapp log tail` |\n| Blob upload CORS | Configure CORS rules on storage account |\n| Bicep deployment error | Validate: `az bicep build --file main.bicep` |\n| Environment variables missing | Check App Settings in Azure Portal |\n| Cold start latency | Use Always On for App Service, or premium SWA tier |\n\n---\n\n## References & Resources\n\n### Documentation\n- [Bicep Quick Reference](.\u002Freferences\u002Fbicep-quickref.md) — Bicep template patterns, resource declarations, modules, and common Azure resource examples\n- [GitHub Actions for Azure](.\u002Freferences\u002Fgithub-actions-azure.md) — GitHub Actions workflows for Azure deployments, OIDC setup, multi-stage pipelines\n\n### Scripts\n- [Deploy to Azure SWA](.\u002Fscripts\u002Fdeploy-swa.ps1) — PowerShell script to deploy Vite\u002FReact or Next.js apps to Azure Static Web Apps\n\n### Examples\n- [Vite SWA Deployment Guide](.\u002Fexamples\u002Fvite-swa-deployment.md) — End-to-end walkthrough deploying a Vite+React app to Azure Static Web Apps\n\n\n---\n\n## Related Skills\n\n- [powerbi-modeling](..\u002Fpowerbi-modeling\u002FSKILL.md): Use it when the workflow also needs Power BI semantic model design and DAX work.\n- [microsoft-development](..\u002Fmicrosoft-development\u002FSKILL.md): Use it when the workflow also needs microsoft development guidance.\n- [sql-development](..\u002Fsql-development\u002FSKILL.md): Use it when the workflow also needs SQL query, schema, and performance tuning work.\n- [documentation-authoring](..\u002Fdocumentation-authoring\u002FSKILL.md): Use it when the workflow also needs drafting structured technical or product documents.\n","# Azure Integrations\n\n> Tech Stack Target \u002F Version: Azure Static Web Apps, App Service, Bicep or ARM templates, GitHub Actions, Node.js 20+, and Azure CLI 2.60+.\n\nDeployment and integration patterns for Azure cloud services, focusing on web application hosting, CI\u002FCD automation, and infrastructure as code.\n\n- Leverage native parallel subagent dispatch and 200k+ context windows where available.\n\n\n## When to Use This Skill\n\nUse symptom -> action triggers: when one matches, apply this skill and verify with the protocol below.\n\n- Deploying Next.js or Vite\u002FReact apps to Azure\n- Setting up CI\u002FCD workflows with GitHub Actions\n- Configuring Azure Static Web Apps or App Service\n- Managing Azure Blob Storage for file uploads\n- Using Azure Key Vault for secure secrets management\n- Setting up Application Insights for monitoring\n- Writing Bicep or ARM templates for infrastructure as code\n- Integrating Azure Cosmos DB (MongoDB API) with applications\n\n\u003C!-- MCP:START -->\n\n\u003C!-- PORTABILITY:START -->\n## Cross-Client Portability\n\nThis skill is written to stay usable across GitHub Copilot, Claude Code, and Codex.\n\n- GitHub Copilot: keep the folder in a Copilot-visible skill path or wrap the\n  workflow in project instructions when folder discovery is unavailable.\n- Claude Code: keep the folder in a local skills directory or a compatible plugin source.\n- Codex: install or sync the folder into\n  `$CODEX_HOME\u002Fskills\u002Fazure-integrations` and restart Codex after major changes.\n\n\u003C!-- PORTABILITY:END -->\n\n## MCP Availability And Fallback\n\nPreferred MCP Server: Azure MCP\n\n- Fallback prompt: \"Use the Azure Integrations skill without MCP. Follow the documented local or manual fallback, show the selected tool surface, and report the verification evidence.\"\n- Use Azure CLI (`az`), Bicep or ARM templates, and the bundled PowerShell deployment scripts in this skill when the MCP server is unavailable.\n- Validate resources with `az` queries, deployment logs, and portal checks before closing the task.\n- Do not claim an MCP operation was used when the active host does not expose it.\n\n\u003C!-- MCP:END -->\n\n## Anti-Patterns\n\n- Changing infrastructure before inspecting the current state: Cloud drift and hidden dependencies make blind edits risky.\n- Hardcoding credentials or environment assumptions: Rollouts stop being reproducible and secrets become harder to rotate.\n- Skipping rollback, observability, or validation planning: You only notice the missing safeguards after the deployment is already live.\n\n## Verification Protocol\n\nBefore claiming \"skill applied successfully\":\n\n1. Pass\u002Ffail: The Azure Integrations implementation names the target runtime, framework version, and affected files.\n2. Pass\u002Ffail: Build, lint, test, or equivalent local validation is run for the changed surface.\n3. Pass\u002Ffail: Edge cases for errors, dependency drift, and environment differences are addressed or explicitly out of scope.\n4. Pressure-test scenario: Apply the workflow to a change that passes happy-path tests but fails one boundary condition.\n5. Success metric: Zero untested success claims; every implementation claim maps to a command or artifact.\n\n## Available Deployment Scripts\n\n- **[examples\u002Fvite-swa-deployment.md](.\u002Fexamples\u002Fvite-swa-deployment.md)** - Vite\u002FReact to Static Web Apps\n- **[examples\u002Fnextjs-app-service-deployment.md](.\u002Fexamples\u002Fnextjs-app-service-deployment.md)** - Next.js to App Service with Key Vault, App Insights, Storage\n- **[scripts\u002Fdeploy-swa.ps1](.\u002Fscripts\u002Fdeploy-swa.ps1)** - PowerShell deployment script for SWA\n- **[scripts\u002Fdeploy-appservice.ps1](.\u002Fscripts\u002Fdeploy-appservice.ps1)** - PowerShell deployment script for App Service\n\n## Reference Documentation\n\n- **[references\u002Fbicep-quickref.md](.\u002Freferences\u002Fbicep-quickref.md)** - Bicep template patterns and syntax\n- **[references\u002Fgithub-actions-azure.md](.\u002Freferences\u002Fgithub-actions-azure.md)** - GitHub Actions patterns for Azure deployments\n\n---\n\n## Azure Static Web Apps\n\n### Deployment Setup\n```yaml\n\n\nname: Deploy to Azure Static Web Apps\n\non:\n  push:\n    branches: [main]\n  pull_request:\n    types: [opened, synchronize, reopened, closed]\n    branches: [main]\n\njobs:\n  build_and_deploy:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions\u002Fcheckout@v4\n\n      - name: Build and Deploy\n        uses: Azure\u002Fstatic-web-apps-deploy@v1\n        with:\n          azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_API_TOKEN }}\n          repo_token: ${{ secrets.GITHUB_TOKEN }}\n          action: \"upload\"\n          app_location: \"\u002F\"\n          api_location: \"api\"\n          output_location: \"dist\"\n```\n\n### Configuration (staticwebapp.config.json)\n```json\n{\n  \"routes\": [\n    { \"route\": \"\u002Fapi\u002F*\", \"allowedRoles\": [\"authenticated\"] },\n    { \"route\": \"\u002F*\", \"serve\": \"\u002Findex.html\", \"statusCode\": 200 }\n  ],\n  \"navigationFallback\": {\n    \"rewrite\": \"\u002Findex.html\",\n    \"exclude\": [\"\u002Fapi\u002F*\", \"*.{css,js,png,jpg,svg,ico}\"]\n  },\n  \"globalHeaders\": {\n    \"X-Content-Type-Options\": \"nosniff\",\n    \"X-Frame-Options\": \"DENY\",\n    \"Content-Security-Policy\": \"default-src 'self'\"\n  },\n  \"responseOverrides\": {\n    \"401\": { \"redirect\": \"\u002Flogin\", \"statusCode\": 302 }\n  }\n}\n```\n\n### Best Practices\n- Use staging environments for PR previews\n- Configure custom domains with SSL\n- Set up authentication providers (Azure AD, GitHub, etc.)\n- Use API routes for serverless backend functions\n\n---\n\n## Azure App Service\n\nFull end-to-end deployment guide with **Key Vault integration, Application Insights, and Azure Storage** available in [examples\u002Fnextjs-app-service-deployment.md](.\u002Fexamples\u002Fnextjs-app-service-deployment.md).\n\n### Quick Reference\n| Resource | Purpose |\n|-----------|---------|\n| **App Service Plan** | Linux hosting for Node.js apps |\n| **Web App** | Next.js application instance |\n| **Key Vault** | Secure secrets management (MongoDB URI, auth secrets) |\n| **Storage Account** | File uploads (recipe images) |\n| **Application Insights** | Monitoring and telemetry |\n| **Managed Identity** | Service-to-service authentication (no passwords) |\n\n### PowerShell Deployment Script\nAutomated deployment script: **[scripts\u002Fdeploy-appservice.ps1](.\u002Fscripts\u002Fdeploy-appservice.ps1)**\n```powershell\n.\\deploy-appservice.ps1 -AppName \"my-app\" -ResourceGroup \"rg-my-app\" -Sku S1 -EnableAppInsights -EnableStorage\n```\n\n### Deployment Workflow\n```yaml\n\n\nname: Deploy Next.js to App Service\n\non:\n  push:\n    branches: [main]\n\npermissions:\n  id-token: write   # Required for OIDC authentication\n\njobs:\n  build-and-deploy:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions\u002Fcheckout@v4\n\n      - name: Setup Node.js\n        uses: actions\u002Fsetup-node@v4\n        with:\n          node-version: '20'\n          cache: 'npm'\n\n      - name: Install and Build\n        run: |\n          npm ci\n          npm run build\n\n      - name: Azure Login (OIDC)\n        uses: azure\u002Flogin@v2\n        with:\n          client-id: ${{ secrets.AZURE_CLIENT_ID }}\n          tenant-id: ${{ secrets.AZURE_TENANT_ID }}\n          subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}\n\n      - name: Deploy to App Service\n        uses: azure\u002Fwebapps-deploy@v3\n        with:\n          app-name: kitchen-odyssey\n          package: .\n```\n\n### Key Features Covered in Full Guide\n- ✅ Zero-downtime deployments with deployment slots\n- ✅ Key Vault integration for secure secrets\n- ✅ Managed Identity authentication (no secrets in app settings)\n- ✅ Application Insights for monitoring and telemetry\n- ✅ Azure Storage for file uploads with CORS\n- ✅ Bicep infrastructure as code templates\n- ✅ Production-ready security headers\n- ✅ Automated CI\u002FCD with GitHub Actions\n\n### App Settings (Key Vault Pattern)\n```bash\n\n\naz webapp config appsettings set --name \u003Capp-name> --resource-group \u003Crg> --settings \\\n  AZURE_KEYVAULT_RESOURCEENDPOINT=\"https:\u002F\u002F\u003Cvault-name>.vault.azure.net\" \\\n  AZURE_CLIENTID=\"\u003CManaged-Identity-Client-ID>\" \\\n  NEXTAUTH_URL=\"https:\u002F\u002F\u003Capp-name>.azurewebsites.net\" \\\n  NODE_ENV=\"production\"\n```\n\n**Legacy Pattern (not recommended - secrets exposed in app settings):**\n```bash\n\n\naz webapp config appsettings set --name \u003Capp-name> --resource-group \u003Crg> --settings \\\n  MONGODB_URI=\"mongodb+srv:\u002F\u002F...\" \\\n  NEXTAUTH_SECRET=\"...\"\n```\n\n\n---\n\n## Azure Blob Storage\n\n### Upload Integration\n```javascript\nimport { BlobServiceClient } from '@azure\u002Fstorage-blob';\n\nconst blobServiceClient = BlobServiceClient.fromConnectionString(\n  process.env.AZURE_STORAGE_CONNECTION_STRING\n);\n\nexport async function uploadFile(containerName, fileName, buffer, contentType) {\n  const containerClient = blobServiceClient.getContainerClient(containerName);\n  await containerClient.createIfNotExists({ access: 'blob' });\n\n  const blockBlobClient = containerClient.getBlockBlobClient(fileName);\n  await blockBlobClient.uploadData(buffer, {\n    blobHTTPHeaders: { blobContentType: contentType },\n  });\n\n  return blockBlobClient.url;\n}\n\nexport async function deleteFile(containerName, fileName) {\n  const containerClient = blobServiceClient.getContainerClient(containerName);\n  const blockBlobClient = containerClient.getBlockBlobClient(fileName);\n  await blockBlobClient.deleteIfExists();\n}\n\nexport async function generateSasUrl(containerName, fileName, expiresInMinutes = 60) {\n  const containerClient = blobServiceClient.getContainerClient(containerName);\n  const blobClient = containerClient.getBlobClient(fileName);\n\n  const sasUrl = await blobClient.generateSasUrl({\n    permissions: BlobSASPermissions.parse('r'),\n    expiresOn: new Date(Date.now() + expiresInMinutes * 60 * 1000),\n  });\n\n  return sasUrl;\n}\n```\n\n---\n\n## Bicep Templates\n\n### Web App + Cosmos DB\n```bicep\n@description('The name of the web app')\nparam appName string\n\n@description('The location for resources')\nparam location string = resourceGroup().location\n\n@description('The SKU of the App Service Plan')\nparam sku string = 'B1'\n\nresource appServicePlan 'Microsoft.Web\u002Fserverfarms@2023-01-01' = {\n  name: '${appName}-plan'\n  location: location\n  sku: {\n    name: sku\n  }\n  properties: {\n    reserved: true\n  }\n  kind: 'linux'\n}\n\nresource webApp 'Microsoft.Web\u002Fsites@2023-01-01' = {\n  name: appName\n  location: location\n  properties: {\n    serverFarmId: appServicePlan.id\n    siteConfig: {\n      linuxFxVersion: 'NODE|20-lts'\n      appSettings: [\n        { name: 'MONGODB_URI', value: cosmosDb.listConnectionStrings().connectionStrings[0].connectionString }\n        { name: 'NODE_ENV', value: 'production' }\n      ]\n    }\n  }\n}\n\nresource cosmosDb 'Microsoft.DocumentDB\u002FdatabaseAccounts@2023-04-15' = {\n  name: '${appName}-db'\n  location: location\n  kind: 'MongoDB'\n  properties: {\n    databaseAccountOfferType: 'Standard'\n    capabilities: [{ name: 'EnableMongo' }]\n    locations: [{ locationName: location, failoverPriority: 0 }]\n  }\n}\n\noutput webAppUrl string = 'https:\u002F\u002F${webApp.properties.defaultHostName}'\n```\n\n### Deployment\n```bash\naz deployment group create \\\n  --resource-group myResourceGroup \\\n  --template-file main.bicep \\\n  --parameters appName=my-recipe-app\n```\n\n---\n\n## GitHub Actions CI\u002FCD Patterns\n\n### Multi-Environment Pipeline\n```yaml\nname: CI\u002FCD Pipeline\n\non:\n  push:\n    branches: [main, staging]\n  pull_request:\n    branches: [main]\n\njobs:\n  test:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions\u002Fcheckout@v4\n      - uses: actions\u002Fsetup-node@v4\n        with: { node-version: '20', cache: 'npm' }\n      - run: npm ci\n      - run: npm run lint\n      - run: npm run test\n\n  deploy-staging:\n    needs: test\n    if: github.ref == 'refs\u002Fheads\u002Fstaging'\n    runs-on: ubuntu-latest\n    environment: staging\n    steps:\n      - uses: actions\u002Fcheckout@v4\n      - run: npm ci && npm run build\n      - uses: azure\u002Fwebapps-deploy@v3\n        with:\n          app-name: ${{ secrets.STAGING_APP_NAME }}\n          publish-profile: ${{ secrets.STAGING_PUBLISH_PROFILE }}\n\n  deploy-production:\n    needs: test\n    if: github.ref == 'refs\u002Fheads\u002Fmain'\n    runs-on: ubuntu-latest\n    environment: production\n    steps:\n      - uses: actions\u002Fcheckout@v4\n      - run: npm ci && npm run build\n      - uses: azure\u002Fwebapps-deploy@v3\n        with:\n          app-name: ${{ secrets.PROD_APP_NAME }}\n          publish-profile: ${{ secrets.PROD_PUBLISH_PROFILE }}\n```\n\n---\n\n## Troubleshooting\n\n| Issue | Solution |\n|-------|----------|\n| SWA deployment fails | Check `output_location` matches build output directory |\n| App Service 500 errors | Check application logs: `az webapp log tail` |\n| Blob upload CORS | Configure CORS rules on storage account |\n| Bicep deployment error | Validate: `az bicep build --file main.bicep` |\n| Environment variables missing | Check App Settings in Azure Portal |\n| Cold start latency | Use Always On for App Service, or premium SWA tier |\n\n---\n\n## References & Resources\n\n### Documentation\n- [Bicep Quick Reference](.\u002Freferences\u002Fbicep-quickref.md) — Bicep template patterns, resource declarations, modules, and common Azure resource examples\n- [GitHub Actions for Azure](.\u002Freferences\u002Fgithub-actions-azure.md) — GitHub Actions workflows for Azure deployments, OIDC setup, multi-stage pipelines\n\n### Scripts\n- [Deploy to Azure SWA](.\u002Fscripts\u002Fdeploy-swa.ps1) — PowerShell script to deploy Vite\u002FReact or Next.js apps to Azure Static Web Apps\n\n### Examples\n- [Vite SWA Deployment Guide](.\u002Fexamples\u002Fvite-swa-deployment.md) — End-to-end walkthrough deploying a Vite+React app to Azure Static Web Apps\n\n\n---\n\n## Related Skills\n\n- [powerbi-modeling](..\u002Fpowerbi-modeling\u002FSKILL.md): Use it when the workflow also needs Power BI semantic model design and DAX work.\n- [microsoft-development](..\u002Fmicrosoft-development\u002FSKILL.md): Use it when the workflow also needs microsoft development guidance.\n- [sql-development](..\u002Fsql-development\u002FSKILL.md): Use it when the workflow also needs SQL query, schema, and performance tuning work.\n- [documentation-authoring](..\u002Fdocumentation-authoring\u002FSKILL.md): Use it when the workflow also needs drafting structured technical or product documents.\n",{"name":5,"tags":25,"version":31,"description":7,"last_updated":32},[26,27,28,29,30],"azure","integrations","cloud","architecture","operations","2.0",1788825600000,"master","fd76f882a04e445e899d5cfb2732f2105ea054ee","skills\u002Fagent-skills\u002Fazure-integrations",0,"https:\u002F\u002Fgithub.com\u002Fbg-szy\u002FTOP-SKILLS","https:\u002F\u002Fbg-szy.github.io\u002FTOP-SKILLS\u002F","https:\u002F\u002Fgithub.com\u002Fbg-szy","https:\u002F\u002Fwww.ecust.edu.cn\u002F","a student of East China University of Science and Technology","2026-11-15 03:38:02",{"source":8,"skillName":5,"commands":44,"prompt":54,"zipAvailable":55},[45,48,51],{"tool":46,"command":47},"npx","npx skills add bg-szy\u002FTOP-SKILLS --skill azure-integrations",{"tool":49,"command":50},"bunx","bunx skills add bg-szy\u002FTOP-SKILLS --skill azure-integrations",{"tool":52,"command":53},"pnpm","pnpm dlx skills add bg-szy\u002FTOP-SKILLS --skill azure-integrations","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fbg-szy\u002FTOP-SKILLS\u002Fblob\u002Fmaster\u002Fskills\u002Fagent-skills\u002Fazure-integrations\u002FSKILL.md",true,[57,63],{"path":58,"resourceType":59,"resourceTypeDesc":60,"sizeBytes":61,"sourceHtmlUrl":62},"CHANGELOG.md","REFERENCE","参考文档",6613,"https:\u002F\u002Fgithub.com\u002Fbg-szy\u002FTOP-SKILLS\u002Fblob\u002Fmaster\u002Fskills\u002Fagent-skills\u002Fazure-integrations\u002FCHANGELOG.md",{"path":64,"resourceType":65,"resourceTypeDesc":66,"sizeBytes":67,"sourceHtmlUrl":16},"LICENSE.txt","LICENSE","许可证",1070,[69,77,84,91,98,105],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":76},"01M7DXW9N826PKXK174PVW3038","serpmaven","Scrape Google search results (SERP) to JSON with SERP Maven (serpmaven) - a real Chrome browser on a residential proxy with sticky sessions. Run it as a CLI, a Python library, a local HTTP search API (`serve`), an MCP server or a Docker image; set the proxy login, workers, pages and cost tracking. Use when the user wants Google results, rank tracking, a self-hosted SERP API, or live Google search for an AI agent.","https:\u002F\u002Fgithub.com\u002Fbg-szy\u002FTOP-SKILLS\u002Fblob\u002Fmaster\u002Fskills\u002Fmarketplace\u002Fserpmaven\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":76},"01M7DXVHSTWDV65475QEQ915M7","revnu-landing-page-audit","Find out why a landing page isn't turning visitors into signups, demos or sales. Audits one page against what the ad, post or search that sends people there promised, then checks the first screen, proof, call to action, friction and mobile. Returns at most 7 prioritized fixes, plus what is fine and what could not be checked; rewrites specific lines and fixes the page in the repo when asked. Never promises a conversion lift. Works without a Revnu account. Use when the user says or asks: \"audit my landing page\", \"why isn't this page converting\", \"review my homepage\", \"my ads get clicks but no signups\", \"people bounce from the pricing page\", \"CRO review\", \"improve conversion rate\", \"is my hero section clear\", \"roast my landing page\", \"rewrite my headline\", \"what's wrong with this page\", \"landing page feedback\", \"make the signup page convert better\". Not for SEO or AI-search audits, page speed engineering on its own, or building a new page from scratch.","https:\u002F\u002Fgithub.com\u002Fbg-szy\u002FTOP-SKILLS\u002Fblob\u002Fmaster\u002Fskills\u002Fmarketplace\u002Frevnu-landing-page-audit\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":76},"01M7DXV8X2D7B3VTD4HHYYHTGR","revnu-growth-context","Write down once who buys, what they're stuck on, what it costs, what proof you have and what you've already tried, so every growth task starts from facts instead of a questionnaire. Creates or updates .agents\u002Frevnu-growth.md from the repo, the live site and the user, and imports an existing product-marketing.md. Use when the user says \"set up our marketing context\", \"who is our ideal customer\", \"write our ICP\", \"describe the product for marketing\", \"positioning doc\", \"what's our brand voice\", \"remember this about our customers\", \"log what we tried\", \"what have we learned from marketing\", \"we changed pricing, update the context\", \"update our growth notes\", \"summarize the business for the agent\", \"import my product-marketing.md\", \"start a growth doc\", or before a first marketing, SEO, outreach or launch task when no context file exists. Works without a Revnu account.","https:\u002F\u002Fgithub.com\u002Fbg-szy\u002FTOP-SKILLS\u002Fblob\u002Fmaster\u002Fskills\u002Fmarketplace\u002Frevnu-growth-context\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":76},"01M7DXV0DGJ1G0A60PAHC6J3C5","revnu-get-listed","Get onto the third-party pages AI answers and search cite when buyers ask for the best tool in your category: \"best X\" roundups, directories, review sites, GitHub awesome lists, community threads and comparison pages. Finds which ones are cited, ranks them by fit and effort, and drafts each submission, PR or pitch by the target's own rules. Use when the user says \"get us listed\", \"which directories should we submit to\", \"how do we get into best-of lists\", \"why does ChatGPT recommend competitors and not us\", \"get mentioned in AI answers\", \"submit to awesome lists\", \"get on G2\", \"where are our competitors listed\", \"pitch listicle authors\", \"find backlink opportunities\", \"launch directories\", \"get into roundups\", \"Product Hunt alternatives\", \"where should we be listed\", \"get cited by Perplexity\". Never submits, pays or posts without a yes. Works without a Revnu account.","https:\u002F\u002Fgithub.com\u002Fbg-szy\u002FTOP-SKILLS\u002Fblob\u002Fmaster\u002Fskills\u002Fmarketplace\u002Frevnu-get-listed\u002FSKILL.md",[],[],{"skillNo":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":76},"01M7DXTSPMGT9D6DSS0HP9BSTA","revnu-ai-readiness-audit","Audit whether your website gives ChatGPT, Perplexity, Claude, Gemini and Google's AI Overviews something worth quoting, and fix the pages that don't. Use when the user says or asks \"is my site ready for AI search\", \"audit my site for AI answers\", \"AEO audit\", \"GEO audit\", \"why doesn't ChatGPT quote our pricing\", \"make our pages citable by AI\", \"do I need llms.txt\", \"does schema help with ChatGPT\", \"check our structured data\", \"is our content visible without JavaScript\", \"AI SEO audit\", \"optimize our homepage for AI answers\", \"LLM SEO check\", \"why does AI get our product wrong\", \"fix our site for AI Overviews\". Checks fetchability and indexability, answers in the raw HTML, entity facts, schema (including JS-injected markup), headings, dates and llms.txt, then gives at most 10 prioritised fixes and edits the repo when asked. Works without a Revnu account.","https:\u002F\u002Fgithub.com\u002Fbg-szy\u002FTOP-SKILLS\u002Fblob\u002Fmaster\u002Fskills\u002Fmarketplace\u002Frevnu-ai-readiness-audit\u002FSKILL.md",[],[],{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":109,"categories":110,"keywords":111,"publishedAt":76},"01M7DXSZHCVTRS620GC3S97JZV","proxy-troubleshooting","Diagnose residential proxy failures, with NodeMaven's gateway as the reference - 407 with correct credentials, 406, 410, 500, a connection that hangs, ERR_TUNNEL_CONNECTION_FAILED in a browser, Playwright or Puppeteer ignoring proxy credentials, a sticky session that changes IP, geo-targeting that is silently ignored, passwords with special characters, and unexpected traffic from headless Chrome. Use when a proxy connection fails, returns the wrong location, or costs more traffic than expected.","https:\u002F\u002Fgithub.com\u002Fbg-szy\u002FTOP-SKILLS\u002Fblob\u002Fmaster\u002Fskills\u002Fmarketplace\u002Fproxy-troubleshooting\u002FSKILL.md",[],[]]