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.