ralph-loop-test
The Adom ralph test: a screenshot-driven fix loop for apps.
Point it at the user's running app (almost always a web app in a Hydrogen webview, in pup, or in the native Chrome/Edge browser, sometimes a desktop app driven via an adom-desktop bridge):
- Load the app on a surface you can screenshot.
- Screenshot it, and feed the shot to the AI.
- The AI analyzes what is wrong and fixes it.
- Reload the page (or reload the file in the desktop app).
- Screenshot again and
shotlog injectso you and the user can see it. - Loop until it is right.
It is the visual equivalent of a Ralph Wiggum loop: the same look, fix, reload cycle, over and over,
until the screenshot is correct. The skill documents every Adom screenshot surface (adom-cli
Hydrogen webview, pup, the native browser extension nbrowser_*, and adom-desktop bridges), when
to use each, the always-run-in-the-background doctrine, window/tab/taskbar etiquette, and why shotlog
is the real image viewer (the Claude Code VS Code extension cannot show images inline).
Install
adom-wiki pkg install adom/ralph-loop-test
Installs to ~/.claude/skills/ralph-loop-test/. Ships in the adom/core baseline. See SKILL.md for
the full method.
# ralph-loop-test
The Adom **ralph test**: a screenshot-driven fix loop for apps.
Point it at the user's running app (almost always a **web app** in a Hydrogen webview, in pup, or in
the native Chrome/Edge browser, sometimes a **desktop app** driven via an adom-desktop bridge):
1. **Load** the app on a surface you can screenshot.
2. **Screenshot** it, and feed the shot to the AI.
3. The AI **analyzes** what is wrong and **fixes** it.
4. **Reload** the page (or reload the file in the desktop app).
5. **Screenshot again** and `shotlog inject` so you and the user can see it.
6. **Loop** until it is right.
It is the visual equivalent of a Ralph Wiggum loop: the same look, fix, reload cycle, over and over,
until the screenshot is correct. The skill documents every Adom screenshot surface (`adom-cli`
Hydrogen webview, `pup`, the native browser extension `nbrowser_*`, and `adom-desktop` bridges), when
to use each, the always-run-in-the-background doctrine, window/tab/taskbar etiquette, and why shotlog
is the real image viewer (the Claude Code VS Code extension cannot show images inline).
## Install
```bash
adom-wiki pkg install adom/ralph-loop-test
```
Installs to `~/.claude/skills/ralph-loop-test/`. Ships in the `adom/core` baseline. See `SKILL.md` for
the full method.