What is a Server Runtime Contract?

It is a formalized agreement defining how a backend service runs in production, covering ports, environment variables, startup methods, and health check standards.

Can this be used for staging environments?

Yes, while primarily for production, it is highly effective for any environment where consistency and reliability are required.

Which deployment methods are supported?

It supports standard industry tools including PM2, systemd, and Docker, providing specific command sets for each.

Why focus on a single 'env authority'?

Many production bugs stem from overlapping environment variables; this skill forces a single source of truth (file, process injection, or container env) to prevent configuration drift.

How does this help with 502/504 gateway errors?

By standardizing port mapping and health checks, it helps you quickly identify if the backend process is running and if the reverse proxy is correctly configured.

Server Runtime Contract

Name: Server Runtime Contract
Author: xiaxingxiaowei1983

byxiaxingxiaowei1983

0•

部署与 DevOps

Standardizes backend production deployment by creating a formal contract for ports, environment variables, startup procedures, and health checks.

The Server Runtime Contract skill eliminates deployment uncertainty by formalizing exactly how backend services operate in production environments. It provides a structured framework to define authoritative environment variable sources, fixed port mapping, process daemonization, and clear health check standards. By replacing tribal knowledge with a documented 'contract,' it ensures that updates take effect reliably, ports remain stable, and troubleshooting follows a predictable path across PM2, systemd, or Docker deployments. This skill is essential for teams facing configuration drift or inconsistent service behavior after deployment.

主要功能

01Standardizes authoritative environment variable sources to prevent configuration drift

02Defines immutable startup, restart, and monitoring commands for PM2, systemd, and Docker

03Formalizes logging and port management to ensure service visibility and security

04Establishes multi-level health check criteria to verify successful deployments

050 GitHub stars

06Maps prioritized troubleshooting paths (P1-P3) for rapid incident response

使用场景

01Troubleshooting 'not taking effect' errors or 502/504 gateway timeouts in production

02Initial production deployment of a backend service to ensure high availability and stability

03Migrating services between servers or switching deployment methods like PM2 to Docker

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add xiaxingxiaowei1983/openclaw h5-server-contract

For use in Claude.ai and ChatGPT

主要功能

01Standardizes authoritative environment variable sources to prevent configuration drift

02Defines immutable startup, restart, and monitoring commands for PM2, systemd, and Docker

03Formalizes logging and port management to ensure service visibility and security

04Establishes multi-level health check criteria to verify successful deployments

050 GitHub stars

06Maps prioritized troubleshooting paths (P1-P3) for rapid incident response

使用场景

01Troubleshooting 'not taking effect' errors or 502/504 gateway timeouts in production

02Initial production deployment of a backend service to ensure high availability and stability

03Migrating services between servers or switching deployment methods like PM2 to Docker