hermes-s6-container-supervision

Modify and debug the s6-overlay supervision tree in the Hermes Agent Docker image.

31|3|Updated May 7, 2026
One-click install
npx skills add https://github.com/markwang2658/hermes-windows-native --skill hermes-s6-container-supervision-markwang2658
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hermes-s6-container-supervision
Source: https://github.com/markwang2658/hermes-windows-native/tree/main/hermes-agent/optional-skills/devops/hermes-s6-container-supervision
Command: npx skills add https://github.com/markwang2658/hermes-windows-native --skill hermes-s6-container-supervision-markwang2658

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Modify, debug, or extend the s6-overlay supervision tree inside the Hermes Agent Docker image — adding new services, debugging profile gateways, understanding the Architecture B main-program pattern.

Core Features & Use Cases

  • Inspect and modify cont-init.d and s6-rc.d to influence boot-time behavior and per-profile gateway supervision.
  • Diagnose why a per-profile gateway isn't starting, restarting, or surviving container restarts, with guided steps to verify run scripts and service states.
  • Understand and document the Architecture B pattern where the CMD is the main program under s6 to ensure correct startup sequencing and exit behavior.
  • Streamline troubleshooting with reproducible steps for container boot reconciliation and runtime supervision.

Quick Start

Start a Hermes container and begin a guided debugging workflow using cont-init.d changes and s6-service commands.

Frequently Asked Questions about hermes-s6-container-supervision

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a per-profile gateway that isn't starting in s6-overlay?

You can debug a per-profile gateway in s6-overlay by verifying run scripts and checking service states. This Skill guides you through inspecting cont-init.d and s6-rc.d to diagnose why the gateway fails to start, restart, or survive container restarts.

What is the Architecture B pattern for Docker container supervision?

The Architecture B pattern is a Docker run-time model where the CMD operates as the main program under s6 supervision. It dictates correct startup sequencing and exit behavior to ensure container stability and reliable service supervision.

How do I add a new static service to the s6-overlay supervision tree?

To add a static service to the s6-overlay supervision tree, you modify cont-init.d and s6-rc.d directories to influence boot-time behavior. This involves describing required files, implementing integration steps, and running validation checks to ensure the service loads correctly at container boot.

Why does my Docker container fail to start reliably after modifying s6 services?

Your Docker container may fail to start reliably if s6-overlay boot-time wiring is incorrect. You need to verify cont-init.d and s6-rc.d configurations, ensure the Architecture B main-program pattern is followed, and run validation checks to reconcile container boot and runtime supervision.

Can I use s6-service commands to troubleshoot Hermes Agent container startup issues?

Yes, you can use s6-service commands to troubleshoot Hermes Agent container startup issues. By starting a Hermes container and using these commands alongside cont-init.d changes, you can execute a guided debugging workflow to stabilize container startup and runtime supervision.