---
name: obs-overlay-builder
description: Builds a streamer overlay (countdown, challenge card, radar, progress bar) as one HTML file usable as an OBS browser source with transparent background and URL parameters. Use when the user asks for a stream overlay or widget.
---

# Rules
- One file overlay.html, no external resources.
- Transparent background by default (html, body {background: transparent}).
- Read options from the URL query string: ?title=, ?color=, ?size=, ?seed=. Provide safe defaults.
- Fixed design size 1920x1080 or a stated widget size; scale with CSS only.
- prefers-reduced-motion fallback. Text contrast >= 4.5:1 on dark and light video.
- Original artwork only.

# Procedure
1. State the widget, its parameters and the OBS source size to use.
2. Build the file.
3. Give OBS steps: Sources > Add > Browser > URL or Local file, width/height, refresh.
4. List what to test: transparency, resize, reload, long text.
