hermes-s6-container-supervision

Modify, debug, or extend the s6-overlay supervision tree in the Hermes Agent Docker image.

Updated Jun 13, 2026
One-click install
npx skills add https://github.com/DonZzzilla/kalshi-explorer --skill hermes-s6-container-supervision-donzzzilla
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hermes-s6-container-supervision
Source: https://github.com/DonZzzilla/kalshi-explorer/tree/main/skills/user-skills/software-development/hermes-s6-container-supervision
Command: npx skills add https://github.com/DonZzzilla/kalshi-explorer --skill hermes-s6-container-supervision-donzzzilla

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides the means to modify, debug, or extend the s6-overlay supervision tree within the Hermes Agent Docker image, allowing users to add new services, diagnose issues, and understand the container's architecture.

Core Features & Use Cases

  • Service Management: Add or remove services in the Hermes Docker image for comprehensive container supervision.
  • Gateway Diagnostics: Identify the root cause of per-profile gateway failures, ensuring reliable container restarts.
  • Understanding Architecture: Learn about the container's CMD structure and the leading-dash arguments handling mechanism.
  • Script Customization: Modify cont-init.d boot scripts for UID remapping, volume seeding, and profile reconciliation.
  • Use Case: Suppose you need to troubleshoot a gateway in a Hermes Docker container that's failing to start. Use this Skill to adjust the supervision tree, diagnose the issue, and get the gateway back up.

Quick Start

To bring a service up manually, execute the following command within the container: s6-svc -u /run/service/gateway-<name>.

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 add a new service to an s6-overlay supervision tree in Docker?▼

You add a new service by modifying the s6-overlay supervision tree within the Hermes Docker image. This involves creating service directories and configuring scripts so the container automatically manages the new service lifecycle.

Why does my Docker container gateway fail to start during s6-overlay initialization?▼

Gateway failures during s6-overlay initialization stem from misconfigured service scripts or per-profile supervision tree errors. Diagnose these issues by checking the container architecture and adjusting the s6 service configurations for reliable restarts.

How do I manually start an s6-overlay service in a running Docker container?▼

To manually start an s6-overlay service, execute the command `s6-svc -u /run/service/gateway-<name>` within the running Docker container. This signals the supervision tree to bring the specified gateway service up immediately.

Can I modify Docker boot scripts for UID remapping and volume seeding?▼

Yes, you can modify the `cont-init.d` boot scripts in the Hermes Docker image. Adjusting these s6-overlay scripts allows you to handle UID remapping, volume seeding, and profile reconciliation during the container initialization process.

How does the Hermes Docker container handle leading-dash arguments in the CMD structure?▼

The Hermes Docker container uses a specific mechanism in its CMD structure to handle leading-dash arguments during startup. Understanding this architecture is necessary for properly extending the s6-overlay supervision tree and passing arguments to services.

What do I need to know before debugging the s6-overlay supervision tree in the Hermes Agent?▼

Before debugging the s6-overlay supervision tree, you need familiarity with Docker, s6-overlay, and the Hermes Agent architecture. This prerequisite knowledge is required to safely modify boot scripts and manage container services.