skill

Ralph Test

Public Made by Adom

by adom

Screenshot, fix, reload. Loop until your app is right.

ai-agentscreenshotdebuggingralphloopbrowser-automationshotlogtesting
Overview Files Skills Discover Packages Releases Dependencies Issues Breadcrumbs Pull Requests Activity
master
Download ZIP Propose a change
Name Last commit message Last updated
screenshots Publish 1.0.0 · John Lauer 3mo ago
install.sh Publish 1.0.0 · John Lauer 3mo ago
package.json Publish 1.0.4 · Colby Knox 1d ago
page.json 1.0.4: skill cleanup: hidden from the model (still /ralph-loop-test), adom-bridge-cli to adom-bridge, browser_* to pup_… · Colby Knox 1d ago
README.md Initial commit: skill/ralph-loop-test · John Lauer 3mo ago
SKILL.md Publish 1.0.4 · Colby Knox 1d ago
uninstall.sh Publish 1.0.0 · John Lauer 3mo ago

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

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.