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
Propose a change
Name Last commit message Last updated
screenshots Publish 1.0.0 21d ago
install.sh Publish 1.0.0 21d ago
package.json Publish 1.0.0 21d ago
page.json Initial commit: skill/ralph-loop-test 21d ago
README.md Initial commit: skill/ralph-loop-test 21d ago
SKILL.md Publish 1.0.0 21d ago
uninstall.sh Publish 1.0.0 21d 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.