qa-detect-viewport-units

Detect 100vh clipping and retina-blurry images in web pages.

Updated May 22, 2026
One-click install
npx skills add https://github.com/Luqman-Ud-Din/blackbox-qa-agent --skill qa-detect-viewport-units
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qa-detect-viewport-units
Source: https://github.com/Luqman-Ud-Din/blackbox-qa-agent/tree/main/skills/qa-detect-viewport-units
Command: npx skills add https://github.com/Luqman-Ud-Din/blackbox-qa-agent --skill qa-detect-viewport-units

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill finds two mobile-only responsiveness defects that are easy to miss in desktop testing: layouts using 100vh without a dynamic viewport fallback, and raster images that will look blurry on high-DPR screens.

Core Features & Use Cases

  • Viewport-height auditing: Scans stylesheets and live elements for 100vh usage that can clip content behind mobile browser chrome.
  • Retina image quality checks: Flags raster images that lack sufficient native resolution or srcset support for crisp display on 2x devices.
  • Use Case: A landing page looks fine on desktop but its full-height hero is cut off on iPhone and its product photos appear soft on mobile; this Skill surfaces both issues automatically.

Quick Start

Ask the Skill to inspect the current page for mobile viewport-height bugs and blurry images, then report each finding with the affected selector and a short fix recommendation.

Frequently Asked Questions about qa-detect-viewport-units

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

FAQPage Schema
Why does my 100vh full-height layout get clipped behind mobile browser chrome?

Using 100vh for full-height layouts clips content because mobile browser chrome dynamically adjusts the viewport height. You need dynamic viewport units like dvh as a fallback to ensure responsive layouts adapt correctly to mobile browser chrome changes.

How do I check my website for missing retina 2x image sources?

To check for missing retina 2x image sources, inspect image elements and validate that raster images have sufficient native resolution or srcset support. This ensures images render crisply on high-DPR mobile screens instead of appearing blurry.

What is the best way to audit a responsive page for mobile viewport height bugs?

The best way to audit mobile viewport height bugs is to scan stylesheets and live DOM elements for 100vh usage. This identifies where static viewport units lack dynamic fallbacks and cause full-height layouts to clip behind mobile browser chrome.

Do I need to manually measure the live DOM to detect mobile rendering defects?

Yes, detecting mobile rendering defects requires live DOM measurement and stylesheet inspection. This process directly validates image resolution and viewport height clipping that standard desktop testing misses on high-DPR mobile routes.

Does this responsive auditing work for full-height hero sections on high-DPR devices?

Yes, responsive auditing works for full-height hero sections on high-DPR devices by validating image resolution and viewport height clipping. It automatically surfaces both 100vh misuse and missing 2x image sources on mobile routes.