Azure Static Web Apps skill for Claude Code: create, test and deploy with the SWA CLI

A skill that makes Claude create, configure and deploy Azure Static Web Apps with the SWA CLI.

Installs: 8.9K; on skills.sh
Stars: 40.7K; on GitHub
Updated: Oct 2026; last repo commit

azure-static-web-apps makes Claude work with the SWA CLI (swa): run swa init, test locally with swa start, then swa login and swa deploy. It also covers staticwebapp.config.json, adding an Azure Functions API and a GitHub Actions workflow. The description says to use it when deploying static sites to Azure or setting up SWA local development.

It installs @azure/static-web-apps-cli with npm and needs an Azure account to deploy. It bundles no scripts.

Good for

Front-end developers deploying a static site to Azure
Developers who want a local SWA emulator with an API proxy and auth simulation
Teams adding GitHub Actions deployment for Static Web Apps

Install azure-static-web-apps

Claude Code

Copy this prompt.

Install the azure-static-web-apps skill in Claude Code. Run this command:

npx skills add https://github.com/github/awesome-copilot --skill azure-static-web-apps

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

The skills CLI and folder routes copy this one skill folder.

From the vendor's docs. Source.

What's in the skill

When it loads

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.

Sections in SKILL.md

Overview
General Instructions
Installation
Quick Start Workflow
Configuration Files
Command-line Reference
swa login
swa init
swa build
swa start
swa deploy
swa db
Scenarios
Create SWA from Existing Frontend and Backend
Add Azure Functions Backend
Set Up GitHub Actions Deployment

Key facts

Author: Not stated in SKILL.md; published in GitHub's awesome-copilot repo
License: MIT (repo LICENSE, Copyright GitHub, Inc.)
Installs on skills.sh: 8,927 as of 2026-11-02
GitHub stars: 40,666 for the whole awesome-copilot repo, 2026-11-02
Last change to this skill: 2026-10-30
What is inside: 1 file: SKILL.md
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk pass

What it includes

Installs the SWA CLI as a dev dependency in your project.
SKILL.md installs @azure/static-web-apps-cli with npm install -D and checks it with npx swa --version.
Runs code · Installation
Detects your framework and creates swa-cli.config.json. Run it first.
SKILL.md says never to create swa-cli.config.json by hand. swa init --yes accepts the detected defaults.
Write · swa init
Runs the local emulator on port 4280 with an API proxy and auth simulation.
Runs code · swa start
Builds the frontend and the API, from config or with --auto.
Runs code · swa build
Signs in to Azure, with options for subscription, tenant, client id and secret.
Network · swa login
Deploys to Azure Static Web Apps, with --env, --deployment-token and --dry-run.
Write · swa deploy
Initializes a database connection for mssql, postgresql or cosmosdb_nosql.
Write · swa db
Walks through install, init, build, local test, login and deploy to production.
Create from an existing app
Creates an api folder with func init, adds a sample function and sets the API runtime.
The steps use func init and func new, a message function, platform.apiRuntime in staticwebapp.config.json and apiLocation in swa-cli.config.json. Listed runtimes are node:18, node:20, node:22, dotnet:8.0, dotnet-isolated:8.0, python:3.10 and python:3.11.
Runs code · Add an Azure Functions backend
Adds a workflow that deploys on pushes and pull requests to main.
The workflow uses Azure/static-web-apps-deploy@v1 and a repository secret named AZURE_STATIC_WEB_APPS_API_TOKEN.
Write · GitHub Actions deployment
Sets routes, auth rules, a navigation fallback and the API runtime.
Write · staticwebapp.config.json
Maps 8 problems, such as 404 on client routes or an expired token, to fixes.
Troubleshooting table

From the official docs

Permissions

Medium risk

It can deploy your site to Azure and handles deployment tokens, which are secrets. Use --dry-run first and keep the token out of chat and git.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

swa deploy publishes your site to Azure
SKILL.md shows swa deploy --env production. Run swa deploy --dry-run first, as SKILL.md suggests, and check which Azure resource it targets. github.com
Deployment tokens are secrets
The token comes from the Azure Portal, swa deploy --print-token or SWA_CLI_DEPLOYMENT_TOKEN. Keep it out of chat, shell history and git. Store it only as a repo secret. github.com
It installs an npm package
The first step is npm install -D @azure/static-web-apps-cli in your project. That changes package.json and the lockfile. github.com
swa login can take a client secret
SKILL.md lists --client-id, --client-secret and --tenant-id flags. A secret typed on a command line can land in shell history, so use the interactive login if you can. github.com
swa init --yes skips the questions
SKILL.md offers swa init --yes to accept auto-detected defaults. Read the generated swa-cli.config.json afterwards. github.com
The GitHub Actions workflow deploys on every push to main
The sample workflow deploys on pushes and pull requests to main using your deployment token secret. Check the branch and secret before you commit it. github.com

Technical details

Scopes	Runs npm install -D @azure/static-web-apps-cli and swa commands in your project Writes swa-cli.config.json, staticwebapp.config.json and an optional GitHub Actions workflow swa login and swa deploy talk to your Azure account

Questions

What does the Azure Static Web Apps skill do?

It makes Claude follow a fixed workflow with the SWA CLI: init the project, test it locally, log in to Azure and deploy. It also helps with Azure Functions APIs, route and auth config, and GitHub Actions deployment.

How do I install it in Claude Code or Codex?

Use the install box above. It copies this one skill folder, or you can use the gh skills install command from the awesome-copilot skills index. The skill then installs the SWA CLI in your project when it needs it.

Do I need an Azure account?

For deploying, yes. swa login signs in to Azure and swa deploy publishes to an Azure Static Web Apps resource. Local work with swa start runs an emulator on your machine, at http://localhost:4280 by default.

How does deployment authenticate?

SKILL.md lists three ways to get a deployment token: the Azure Portal, swa deploy --print-token, or the SWA_CLI_DEPLOYMENT_TOKEN environment variable. The GitHub Actions workflow reads it from a repo secret named AZURE_STATIC_WEB_APPS_API_TOKEN.

Can I preview a deployment first?

Yes. SKILL.md lists swa deploy --dry-run as a way to preview without deploying.

Is it safe?

It installs an npm package, writes config files and, when you ask, deploys your site to Azure. Our advice: use --dry-run first, keep deployment tokens out of chat and commits, and read any workflow file before you merge it.

Information

updated Nov 2, 2026

Repository: github/awesome-copilot
Folder: skills/azure-static-web-apps

github/awesome-copilot skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4

awesome-copilot skills index · github.com
azure-static-web-apps SKILL.md · github.com
awesome-copilot LICENSE · github.com
skills.sh listing · skills.sh