caddy/SKILL.md

name, description, metadata

name	description	metadata
caddy	Caddy web server with automatic HTTPS	version vibestack 1.0.0 main false

Caddy Skill

Installs and configures Caddy web server with automatic HTTPS.

Features

• Automatic HTTPS with Let's Encrypt
• Reverse proxy support
• Static file serving
• Zero-downtime reloads

Configuration

Create a Caddyfile in your skill's directory or set CADDYFILE_PATH environment variable.

Environment Variables

Variable	Description	Default
CADDYFILE_PATH	Path to Caddyfile	/skills/caddy/Caddyfile
CADDY_DATA_DIR	Caddy data directory	/data/caddy

Example Caddyfile

:80 {
    respond "Hello from Caddy!"
}

# Reverse proxy example
# api.example.com {
#     reverse_proxy localhost:8080
# }

Auto-Import from Skills

Other skills can drop .caddy snippets into caddy/snippets.d/ and they'll be automatically merged at startup.

Example: If ttyd skill is present with TTYD_DOMAIN=terminal.example.com, it creates:

caddy/snippets.d/ttyd.caddy

Caddy's run.sh merges all snippets into the config before starting.

Usage

This skill is typically used as a dependency by other skills that need a web server:

metadata:
  vibestack:
    requires:
      - caddy