---
name: homepage
description: Dynamic dashboard - auto-discovers and displays all skills
metadata:
  version: "1.0.0"
  vibestack:
    main: false
---

# Homepage Skill

Dynamic dashboard that auto-discovers skills and shows their status.

## Features

- Auto-discovers skills from `/skills` directory
- Parses SKILL.md for name, description, ports
- Live health status checks
- Links to skill endpoints
- Minimal resource usage (~0 extra, just bash + socat)

## Configuration

| Variable | Description | Default |
|----------|-------------|---------|
| `HOMEPAGE_PORT` | Dashboard port | `3000` |
| `HOMEPAGE_DOMAIN` | Domain for Caddy auto-config | (none) |
| `HOMEPAGE_TITLE` | Page title | `VibeStack` |

## Endpoints

- `GET /` - Dashboard HTML
- `GET /api/skills` - JSON list of skills with status
- `GET /health` - Health check

## What It Shows

For each skill:
- Name and description
- Health status (up/down)
- Ports (parsed from SKILL.md or known defaults)
- Link to open (if applicable)

## Customization

The HTML template is in the skill's scripts. Claude can modify it to change the look.