hermes-s6-container-supervision

Modify and extend the s6-overlay supervision tree in Hermes Agent Docker images.

1|Updated Jun 9, 2026
One-click install
npx skills add https://github.com/lxt070409/hermes-skills --skill hermes-s6-container-supervision-lxt070409
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hermes-s6-container-supervision
Source: https://github.com/lxt070409/hermes-skills/tree/main/software-development/hermes-s6-container-supervision
Command: npx skills add https://github.com/lxt070409/hermes-skills --skill hermes-s6-container-supervision-lxt070409

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill allows users to modify, debug, or extend the s6-overlay supervision tree inside the Hermes Agent Docker image, enabling the addition of new services, debugging profile gateways, and understanding the Architecture B main-program pattern.

Core Features & Use Cases

  • Container Supervision: Modify and extend the s6-overlay supervision tree for Docker images.
  • Service Management: Add or remove static services in the Docker image.
  • Gateway Diagnostics: Diagnose issues with per-profile gateways.
  • Profile Reconciliation: Understand and modify cont-init.d boot scripts and run-scripts for gateways.
  • Use Case: If you're working on the Hermes Agent Docker image and need to debug a service that's not starting or understand the internal architecture of the Docker image, this skill is essential.

Quick Start

Load the skill and use the provided commands to inspect and manage services within the Hermes Agent Docker image.

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 a Docker image using s6-overlay supervision?

To add a new service to a Docker image using s6-overlay supervision, you modify the supervision tree by adding static service directories and scripts. This enables proper service management and startup within the Hermes Agent container architecture.

How does the s6-overlay supervision tree work in Docker containers?

The s6-overlay supervision tree in Docker containers manages processes through a structured init system. It uses `cont-init.d` boot scripts and run-scripts to execute services and reconcile profiles, ensuring reliable container startup and process supervision.

How do I diagnose per-profile gateway issues in Docker?

To diagnose per-profile gateway issues in Docker, you inspect the s6-overlay boot scripts and run-scripts. This process helps identify misconfigurations in profile reconciliation and gateway initialization that prevent services from starting properly.

Do I need prior knowledge of s6-overlay to manage Hermes Agent Docker containers?

Yes, you need prior knowledge of s6-overlay and Hermes Agent to manage these Docker containers. This skill requires understanding the supervision tree architecture and the main-program pattern to implement changes and diagnose service issues effectively.

Why is my Docker service not starting when using s6-overlay?

A Docker service may not start with s6-overlay due to incorrect supervision tree configuration or errors in `cont-init.d` boot scripts. Debugging involves checking profile reconciliation and gateway diagnostics to identify the startup failure point.

What is the Architecture B main-program pattern in container supervision?

The Architecture B main-program pattern in container supervision is a structural approach used within the Hermes Agent Docker image. It defines how the primary program executes within the s6-overlay tree, coordinating service management and profile reconciliation.