qa-detect-modal-viewport-fit

Detect modal and dialog viewport fit issues across desktop and mobile viewports.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill checks whether open modals and dialogs fit within the viewport so users can actually reach important actions like Submit and Cancel without the dialog being clipped or forcing awkward page scrolling.

Core Features & Use Cases

  • Viewport fit validation: Measures modal height against the viewport and flags dialogs that are too tall without internal scrolling.
  • Action accessibility checks: Verifies that modal footers and key buttons remain reachable within the visible screen area.
  • Overflow detection: Detects internal content overflow and width issues that can break mobile or compact layouts.
  • Use case: Use it on forms, drawers, and dialog-heavy flows to catch responsive UI regressions before they reach users.

Quick Start

Ask the assistant to run the modal viewport-fit skill on the current page and report any dialogs whose content, footer, or width breaks responsive usability.

Frequently Asked Questions about qa-detect-modal-viewport-fit

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

FAQPage Schema
How do I check if a modal fits within the viewport on mobile and desktop?

To check modal viewport fit, measure dialog height against the visible screen area and verify that footers and key buttons remain reachable without forcing awkward page scrolling. This detects modals that are too tall and lack internal scrolling.

Why does my responsive dialog overflow content on smaller screens?

Responsive dialog overflow occurs when internal content exceeds viewport boundaries without proper internal scrolling. Width issues and missing overflow behavior detection break compact mobile layouts and prevent users from reading content.

What is modal viewport fit validation in responsive UI audits?

Modal viewport fit validation is an accessibility audit that measures open dialogs, drawers, and triggered flows to ensure content, footers, and width adapt correctly across desktop and mobile viewports without clipping actions.

Can I detect modal footer visibility issues for dialog-heavy forms?

Yes, you can detect modal footer visibility issues by performing in-page measurements that verify key action buttons remain within the visible screen area. This catches responsive UI regressions in dialog-heavy form flows.

When do I need to audit dialog overflow behavior for accessibility?

You need to audit dialog overflow behavior for accessibility when users cannot reach important actions like Submit and Cancel because the dialog is clipped. This applies to open modals, drawers, and dialog-triggered flows across viewports.