Graceful Shutdown

This handles the unsexy but critical work of shutting down your application without dropping requests or leaking resources. It covers the full stack: tracking active connections, rejecting new requests during shutdown, waiting for in-flight work to finish, and cleaning up database pools and other resources. The guides show Express, Flask, PM2, and Kubernetes setups, which is the right mix since shutdown logic varies enough between environments that you can't just copy-paste. The 30-second default timeout is reasonable but you'll want to tune it based on your actual request durations. Worth implementing before your first production incident, not after.

skills.sh installs: 439
GitHub stars: 379
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add aj-geddes/useful-ai-prompts --skill graceful-shutdown --agent claude-code

Installs into .claude/skills of the current project.

Files

Overview

Implement proper shutdown procedures to ensure all requests are completed, connections are closed, and resources are released before process termination.

When to Use

Kubernetes/Docker deployments
Rolling updates and deployments
Server restarts
Load balancer drain periods
Zero-downtime deployments
Process managers (PM2, systemd)
Long-running background jobs
Database connection cleanup

Quick Start

Minimal working example:

import express from "express";
import http from "http";

class GracefulShutdownServer {
  private app: express.Application;
  private server: http.Server;
  private isShuttingDown = false;
  private activeConnections = new Set<any>();
  private shutdownTimeout = 30000; // 30 seconds

  constructor() {
    this.app = express();
    this.server = http.createServer(this.app);
    this.setupMiddleware();
    this.setupRoutes();
    this.setupShutdownHandlers();
  }

SKILL.md on GitHub