yapuilisted
Install: claude install-skill Tatendaz/yapui
# YapUI — HTML Live Preview + Feedback
Turns "open this HTML" into a live loop: the user views the page in their browser and gives feedback by **typing, talking, recording the screen, screenshotting, or clicking to pick an element** — and a **resident pre-warmed agent** (booted by the relay itself) picks it up instantly, fixes it, and replies in the browser. They never have to come back to the terminal, and nothing polls: the browser is fed over SSE, the agent over stdin.
The backend relay, the injected widget, and the resident agent live next to this file under `relay/` (`relay/server.js`, `relay/widget.js`, `relay/agent.js`). This skill folder is referred to below as `<SKILL_DIR>` (e.g. `~/.claude/skills/yapui`).
## When to use
Any request to **see / preview / open / serve / render** an HTML file in the browser — a mockup, prototype, report, component, or page. Prefer this over `open file.html`.
## Launch (do these)
Target HTML = **$HTML** (absolute path).
1. **Free port** — try 8765, then 8766, 8780, 8790 (`lsof -iTCP:$p -sTCP:LISTEN -t` empty = free).
2. **Workdir** for feedback artifacts — default `"$(dirname "$HTML")/.yapui"` (safe to gitignore/delete).
3. **Start the relay (background, `run_in_background: true`):**
```sh
PORT=<port> HTML_FILE="$HTML" WORKDIR="<workdir>" node "<SKILL_DIR>/relay/server.js"
```
The relay immediately spawns and **pre-warms a resident headless `claude` agent** (primed by reading the HTML), so the first note already hits a