Does this support Docker and PM2?

Yes, the skill is designed to work with various deployment methods including PM2, systemd, and Docker, providing specific command templates for each.

How does this skill help with 502 Bad Gateway errors?

It provides a prioritized troubleshooting path (P1-P3) to systematically check if the backend process is running, if logs show dependency errors, or if the Nginx reverse proxy is correctly configured.

What is a Server Runtime Contract?

It is a formal specification that defines exactly how a backend service should run, covering its port, environment variable source, daemon process, and health check criteria to ensure consistency across environments.

Why is a single authoritative ENV source important?

Having multiple sources for environment variables often leads to 'configuration drift' where changes are made in one file but overridden by another, causing unexpected behavior in production.

Server Runtime Contract

Name: Server Runtime Contract
Author: xiaxingxiaowei1983

byxiaxingxiaowei1983

0•

배포 및 DevOps

Standardizes backend deployment protocols including ports, environment variables, daemon management, and health checks to ensure reliable production environments.

The Server Runtime Contract skill provides a structured framework for defining how backend services operate in production. It eliminates deployment ambiguity by codifying critical parameters like the authoritative source for environment variables, fixed port assignments, daemonization strategies (PM2, Docker, or systemd), and verifiable health check standards. By generating a formal Runtime Contract Result Sheet, it helps development teams avoid common pitfalls such as port drifting, environment variable overlaps, and silent service failures, ensuring that every release is measurable, reproducible, and easy to troubleshoot.

주요 기능

01Defines multi-step success verification criteria (S1-S5) for every production release.

020 GitHub stars

03Standardizes service daemonization to ensure automatic recovery using PM2, systemd, or Docker.

04Establishes a single authoritative source for environment variables to prevent configuration drift.

05Provides prioritized troubleshooting paths (P1-P3) for rapid identification of deployment failures.

06Enforces security best practices by standardizing Nginx reverse proxy configurations and port isolation.

사용 사례

01Standardizing deployment workflows across a team to eliminate 'it works on my machine' inconsistencies.

02Performing the initial production deployment or server migration of a backend service.

03Troubleshooting persistent service issues like 502/504 errors or configuration changes not taking effect.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add xiaxingxiaowei1983/ai h5-server-contract

For use in Claude.ai and ChatGPT

주요 기능

01Defines multi-step success verification criteria (S1-S5) for every production release.

020 GitHub stars

03Standardizes service daemonization to ensure automatic recovery using PM2, systemd, or Docker.

04Establishes a single authoritative source for environment variables to prevent configuration drift.

05Provides prioritized troubleshooting paths (P1-P3) for rapid identification of deployment failures.

06Enforces security best practices by standardizing Nginx reverse proxy configurations and port isolation.

사용 사례

01Standardizing deployment workflows across a team to eliminate 'it works on my machine' inconsistencies.

02Performing the initial production deployment or server migration of a backend service.

03Troubleshooting persistent service issues like 502/504 errors or configuration changes not taking effect.