hermes-s6-container-supervision

Debug and extend s6-overlay supervision in Hermes Agent Docker containers.

Updated Feb 21, 2026
One-click install
npx skills add https://github.com/Gitnapp/Skills --skill hermes-s6-container-supervision-gitnapp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hermes-s6-container-supervision
Source: https://github.com/Gitnapp/Skills/tree/main/software-development/hermes-s6-container-supervision
Command: npx skills add https://github.com/Gitnapp/Skills --skill hermes-s6-container-supervision-gitnapp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers understand, debug, and modify the complex s6-overlay supervision architecture inside the Hermes Agent Docker image, reducing confusion around service lifecycle management and container startup behavior.

Core Features & Use Cases

  • s6 Architecture Guidance: Explains PID 1 behavior, s6-rc services, runtime-registered gateway services, and the Architecture B main-program pattern.
  • Container Debugging Workflows: Provides procedures for diagnosing gateway startup failures, restart issues, ownership problems, and supervision state errors.
  • Service Management Support: Covers adding static services, modifying gateway run scripts, reconciling profiles, and maintaining Docker initialization flows.

Quick Start

Ask the AI to diagnose why a Hermes container gateway service is failing under s6 supervision and suggest the appropriate debugging steps.

Frequently Asked Questions about hermes-s6-container-supervision

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

FAQPage Schema
How does s6-overlay supervision work inside a Hermes Agent Docker container?

s6-overlay supervision manages Hermes Agent Docker container processes by running PID 1 to control s6-rc services, runtime-registered gateway services, and the main-program execution pattern. It handles initialization scripts and coordinates the service lifecycle during boot reconciliation.

How do I debug a failing gateway service under s6 supervision in Docker?

To debug a failing s6 supervised gateway service, diagnose startup failures, restart issues, and ownership problems by inspecting the supervision state errors. Check s6-rc service registration logs and verify Hermes container boot reconciliation to identify the root cause.

What's the best way to add a static service to an s6-overlay supervision tree?

The best way to add a static service to an s6-overlay supervision tree involves registering the service through s6-rc, modifying gateway run scripts, and ensuring proper Docker initialization flow. Maintain Hermes container boot reconciliation to integrate the new service cleanly.

Why does my Hermes container gateway keep restarting under s6 supervision?

Your Hermes container gateway keeps restarting under s6 supervision due to supervision state errors, incorrect service registration, or ownership problems in the run scripts. Inspect s6-rc logs and verify the main-program execution pattern to resolve the restart loop.

Do I need to understand s6-rc service registration to maintain Hermes Docker containers?

Yes, you need to understand s6-rc service registration to maintain Hermes Docker containers. Troubleshooting container supervision, reconciling profiles, and modifying gateway run scripts all require knowledge of s6-overlay service registration and boot reconciliation behavior.

Can I modify Docker initialization scripts without breaking the s6 supervision tree?

You can modify Docker initialization scripts without breaking the s6 supervision tree by following proper service management procedures. Ensure changes to static services and gateway run scripts align with s6-overlay registration patterns and Hermes container boot reconciliation requirements.