nginxlisted

Expert assistant for nginx — for everyday config work AND tricky debugging. Use it to set up a new site from scratch, write or refactor server/location blocks, configure a reverse proxy (proxy_pass, upstreams, load balancing), set up TLS/SSL and certificates, enable HTTP/2 or HTTP/3, wire up WebSockets, serve a SPA/Next.js/React frontend, proxy S3/MinIO, add caching/gzip/brotli, rate limiting, security headers, or real-IP behind a CDN. Also use it to review/harden an existing config, or to debug problems: a site that "won't load", is "slow on mobile", "works through VPN but not directly" (or vice-versa), returns 502/504/413, has redirect loops, or cert/SNI errors. Keywords: nginx, reverse proxy, proxy_pass, location, server block, virtual host, certbot, letsencrypt, websocket, upstream, load balancer, 502 bad gateway.
tensorshift/claude-nginx-skill · ★ 3 · DevOps & Infrastructure · score 76

Install: claude install-skill tensorshift/claude-nginx-skill

# nginx Deep, practical guidance for **writing, configuring, reviewing, and debugging** nginx — a full-spectrum nginx assistant, not just an incident-response tool. Use it for routine setup (new vhost, reverse proxy, TLS, caching, security) just as much as for hard problems. On top of standard best practices it encodes hard-won operational lessons (mobile/MTU black holes, DPI filtering, `add_header` inheritance traps, HTTP/2 syntax drift across versions) so answers are correct and version-aware instead of generic snippets. ## What this skill helps with **Authoring & setup (the everyday case):** - Stand up a new site / virtual host from scratch (HTTP→HTTPS, certs, HTTP/2). - Reverse proxy to an app: correct headers, WebSockets, timeouts, keep-alive. - Frontends (SPA / Next.js / React), object storage (S3/MinIO), APIs. - Load balancing and `upstream` pools. - Caching (static + proxy cache), gzip/brotli compression. - TLS/SSL setup and tuning, HTTP/3, OCSP stapling, redirects. - Security hardening: headers, rate limiting, real-IP behind a CDN, allow/deny. **Review & refactor:** - Audit an existing `.conf` against the checklist below; clean up cruft. **Debug (when something's wrong):** - "Won't load", slow on mobile, VPN asymmetry, 502/504/413, redirect loops, cert/SNI errors — diagnosed from logs, not guesswork. ## How to use this skill 1. **Identify the task type** and jump to the matching reference. For **setup/ authoring**, produce a complete, correct config fr