Agent skill · software engineering · github
azure-static-web-apps
Helps create, configure, and deploy Azure Static Web Apps using the SWA CLI. Use when deploying static sites to Azure, setting up SWA local development, configuring staticwebapp.config.json, adding Azure Functions APIs to SWA, or setting up GitHub Actions CI/CD for Static Web Apps.
Why this skill is useful
Provides specific commands and configuration patterns for deploying Azure Static Web Apps that the AI wouldn't reliably generate on its own.
What it needs
Requires @azure/static-web-apps-cli installed locally. Requires azure account access. About 5k tokens when loaded. Last updated 2026-08-07. 37,534 stars on the source repository.
What this skill does
Overview Azure Static Web Apps (SWA) hosts static frontends with optional serverless API backends. The SWA CLI (swa) provides local development emulation and deployment capabilities. Key features: Local emulator with API proxy and auth simulation Framework auto-detection and configuration Direct deployment to Azure Database connections support Config files: swa-cli.config.json - CLI settings, created by swa init (never create manually) staticwebapp.config.json - Runtime config (routes, auth, headers, API runtime) - can be created manually General Instructions Installation Verify: npx swa --version Quick Start Workflow IMPORTANT: Always use swa init to create configuration files. Never manually create swa-cli.config.json. 1. swa init - Required first step - auto-detects framework and creates swa-cli.config.json 2. swa start - Run local emulator at http://localhost:4280 3. swa login - Authenticate with Azure 4. swa deploy - Deploy to Azure Configuration Files swa-cli.config.json - Created by swa init, do not create manually: Run swa init for interactive setup with framework detection Run swa init --yes to accept auto-detected defaults Edit the generated file only to customize settings after initialization Example of generated config (for reference only): staticwebapp.config.json (in app source or output folder) - This file CAN be created manually for runtime configuration: Command-line Reference swa login Authenticate with Azure for deployment. Flags: --subscription-id, -S --resource-group, -R --tenant-id, -T --client-id, -C --client-secret, -CS --app-name, -n swa init Configure a new SWA project based on an existing frontend and (optional) API. Detects frameworks automatically. swa build Build frontend and/or API. Flags: --app-location, -a --api-location, -i --output-location, -O --app-build-command, -A --api-build-command, -I swa start Start local development emulator. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills github/azure-static-web-apps