nginx

nginx is a skill for Claude Code, Codex from tensorshift/claude-nginx-skill. It costs 208 tokens per session (1,793 once invoked), scanned A, original, MIT.

A practical guide for configuring and debugging nginx, a web server and reverse proxy that can route requests to applications and serve websites.

In plain words
What is it for?
Use it to set up sites, reverse proxies, WebSockets, load balancing, caching, compression, TLS certificates, HTTP/2 or HTTP/3, redirects, and security rules.
Why use it?
It helps resolve both routine configuration work and difficult issues involving headers, protocols, certificates, networking, and version differences.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it to set up sites, reverse proxies, WebSockets, load balancing, caching, compression, TLS certificates, HTTP/2 or HTTP/3, redirects, and security rules.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/tensorshift/claude-nginx-skill/nginx
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add tensorshift/claude-nginx-skill --skill nginx
Clone the repo
git clone --depth 1 https://github.com/tensorshift/claude-nginx-skill

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for nginx

README.md
[![agentmods](https://agentmods.dev/badge/skills/tensorshift/claude-nginx-skill/nginx/github.svg)](https://agentmods.dev/skills/tensorshift/claude-nginx-skill/nginx)
Your own site
<a href="https://agentmods.dev/skills/tensorshift/claude-nginx-skill/nginx"><img src="https://agentmods.dev/badge/skills/tensorshift/claude-nginx-skill/nginx/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for nginx

Your own site · 80×15
<a href="https://agentmods.dev/skills/tensorshift/claude-nginx-skill/nginx"><img src="https://agentmods.dev/badge/skills/tensorshift/claude-nginx-skill/nginx.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 208 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,793 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00208 $0.01793
Opus 5 $0.00104 $0.00897
Sonnet 5 $0.00042 $0.00359
Haiku 4.5 $0.00021 $0.00179

Measured 9d ago against content hash 7693095233e4, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

nginx scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

The scan reads SKILL.md. This mod also ships 2 executable files (scripts/diagnose-ip.sh, scripts/nginx-check.sh), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

nginx/SKILL.md · 130 lines

How it starts

The opening of the file, as written. The whole thing — 130 lines — stays where its author put it; the contents beside it link to each section on GitHub.

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 from the patterns in the references (adapted to the user's stack), then validate it. For debugging, diagnose from logs first, then make the minimal correct change — don't paste a generic config at a problem you haven't localized.
  2. Always preserve a path to rollback. Before editing a production .conf, note the original. Never touch ssl_certificate* lines unless explicitly asked.
  3. Validate before declaring done. Every change must pass nginx -t. Tell the user to run nginx -t && systemctl reload nginx (reload, not restart — reload is zero-downtime).
  4. Be version-aware. Several directives changed syntax across nginx releases (see Anti-patterns → "HTTP/2 syntax"). When unsure, ask for nginx -v or use the backward-compatible form.

Read the full file on GitHub · 130 lines

Files

What ships with it

8 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 9d ago First seen · 130 lines · 208 tokens per session scan A 7693095233e4

Subscribe to this mod's changes

nginx is a skill published in the GitHub repository tensorshift/claude-nginx-skill (3 stars, last pushed 3mo ago), licensed MIT. It adds 208 tokens to every session and 1,793 once invoked, about $0.0010 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

aws-essentials

AWS core services guide covering Lambda, S3, RDS, IAM, SQS/SNS, DynamoDB, CloudFront with security and cost optimization patterns.

medy-gribkov/arcana · 36 tokens

docker-kubernetes

Production Docker and Kubernetes patterns including multi-stage builds, minimal base images, non-root users, layer caching, docker-compose for development, K8s Deployments, Services, Ingress, ConfigMaps, Secrets, health checks, resource limits, HPA autoscaling, security contexts, and Helm chart basics. Use when…

medy-gribkov/arcana · 75 tokens

vercel-deploy

Deploy to Vercel with edge functions, ISR, middleware, and proper caching. Use when deploying Next.js apps, configuring preview environments, or optimizing Vercel builds.

medy-gribkov/arcana · 40 tokens

cost-optimization

Cloud cost optimization with concrete examples for right-sizing containers, CDN caching, database query costs, serverless tuning, spot instances, reserved capacity, and build time reduction.

medy-gribkov/arcana · 37 tokens

terraform-iac

Terraform infrastructure as code with state management, modules, workspaces, lifecycle rules, and CI/CD patterns.

medy-gribkov/arcana · 24 tokens

cloudflare-tunnel-routes

Give any local port (Gradio, Streamlit, FastAPI, webhook receiver, dev server, Docker container) a permanent HTTPS URL on a domain the user owns - in one command, no deployment. Use when the user says "my Gradio share link keeps changing", "replace share=True with a permanent URL", "stable URL for localhost:7860"…

nachum10/cloudflare-tunnel-routes · 197 tokens