visual-ralph

Implements frontend UI from approved visual references using measured verdict and pixel-diff iteration.

Updated Feb 1, 2024
One-click install
npx skills add https://github.com/ogiboy/portfolio-app --skill visual-ralph-ogiboy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: visual-ralph
Source: https://github.com/ogiboy/portfolio-app/tree/main/.codex/skills/visual-ralph
Command: npx skills add https://github.com/ogiboy/portfolio-app --skill visual-ralph-ogiboy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building frontend UI from a design description or live website often relies on subjective judgment, leading to implementations that drift from the intended look. This Skill replaces guesswork with a measured loop: an approved visual reference becomes the source of truth, and every iteration is scored against it until the match passes a defined threshold. ## Core Features & Use Cases - Reference-driven implementation: Works from a generated mockup, a static reference image, or a captured live URL baseline, with explicit user approval before any code is written. - Measured iteration loop: Each edit cycle runs a Visual Verdict producing a JSON score, differences, and suggestions; implementation continues until the score reaches 90 or higher, with pixel-diff overlays as secondary debugging evidence. - Reproducible design system output: The final result is encoded as repo-native design tokens and reusable components (colors, spacing, typography, radii, shadows, variants), not a one-off screenshot match. - Use Case: Provide a live URL of a landing page you want recreated; the Skill captures the baseline with viewport and interaction notes, gets your approval, then drives autonomous implementation until the clone visually matches and passes build/lint/test. ## Quick Start Ask the agent to implement a frontend page matching this reference image or live URL using the visual-ralph loop with a verdict score threshold of 90.

Frequently Asked Questions about visual-ralph

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement a frontend UI from a reference image?

Provide or generate a reference image, approve it explicitly, then hand it to the implementation loop with the screenshot command and viewport. Each iteration runs a visual verdict comparing the screenshot to the reference, and edits continue until the score reaches 90 or higher.

How to clone a website from a live URL with visual verification?

Capture the URL baseline with viewport, route state, and interaction parity notes, then get user approval before implementation. The loop iterates with scored visual verdicts and pixel-diff evidence until the clone matches, excluding backend, auth, and personalized data.

What visual similarity score is needed before a UI implementation is done?

The completion threshold is a verdict score of 90 or higher against the approved reference. The verdict JSON includes score, verdict, category_match, differences, suggestions, and reasoning, and remaining differences must be documented with rationale.

When should I not use a visual reference implementation loop?

Skip it for non-visual backend or API work, repo-wide design guidance, or when you only need comparison fixes against an already-final reference image. It also does not fit deterministic SVG or code-native asset generation.

Does pixel diff replace visual verdict scoring?

No. Pixel diff or pixelmatch overlays are secondary debug evidence used to locate mismatch hotspots. The JSON visual verdict remains the authoritative pass/fail signal that drives each next edit plan.