supervisor/SKILL.md

name, description, metadata

name	description	metadata
supervisor	Process manager for running multiple skills concurrently	version vibestack 1.0.0 main true

Supervisor Skill

Runs multiple skills as managed processes using supervisord.

Features

• Auto-discovers skills with run.sh scripts
• Manages process lifecycle (start, stop, restart)
• Log aggregation
• Process health monitoring
• Web UI for process management (optional)

Auto-Discovery

On startup, supervisor scans /skills/*/scripts/run.sh and creates a program entry for each skill that has a run.sh script.

Skills can opt-out by setting SUPERVISOR_SKIP=true in their environment or by not having a run.sh script.

Configuration

Environment Variables

Variable	Description	Default
SUPERVISOR_HTTP_PORT	Web UI port (0 = disabled)	9001
SUPERVISOR_USER	Web UI username	admin
SUPERVISOR_PASSWORD	Web UI password	admin
SUPERVISOR_LOG_DIR	Log directory	/var/log/supervisor

Per-Skill Configuration

Skills can provide a .supervisor.conf file in their directory to customize their process:

[program:my-skill]
priority=100
autostart=true
autorestart=true
startsecs=5

Usage

Supervisor is typically the main: true skill that orchestrates other skills:

SKILL_URLS="https://git.../supervisor https://git.../caddy https://git.../ttyd"
MAIN_SKILL="supervisor"

Web UI

Access at http://localhost:9001 to:

• View process status
• Start/stop/restart processes
• View logs