ava-qa-inspection

Inspect rendered frontend pages for visual and structural defects using deterministic DOM probes.

1|Updated Aug 14, 2026
One-click install
npx skills add https://github.com/zhiyuan-zhang0206/Ava --skill ava-qa-inspection-zhiyuan-zhang0206
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ava-qa-inspection
Source: https://github.com/zhiyuan-zhang0206/Ava/tree/main/ava_builtins/skills/ava-qa-inspection
Command: npx skills add https://github.com/zhiyuan-zhang0206/Ava --skill ava-qa-inspection-zhiyuan-zhang0206

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Static lint rules and jsdom-based unit tests cannot catch defects that only appear once a page is rendered, such as stray scrollbars, misaligned siblings, empty styled blocks, duplicate controls, and elements bleeding off-canvas. This skill audits the real rendered page in a shared Chrome browser and turns each confirmed defect into a deterministic check so it never needs to be found by eye twice. ## Core Features & Use Cases - Deterministic DOM probes: Inject a read-only probe script that measures horizontal overflow, zero-content boxes, sibling-edge misalignment, duplicate accessible names, and off-canvas elements, returning selectors and pixel measurements as evidence. - Structured defect checklist: Classify findings against a severity-ranked checklist (casing, alignment, scrollbar, empty-block, duplicate-control, off-canvas, overflow-clip, and more) with defined evidence requirements and severity floors. - Defect graduation workflow: Convert confirmed findings into permanent ESLint rules or Playwright assertions so each defect class is blocked at PR rather than rediscovered manually. - Use Case: After a UI rollout, sweep every top-level route at desktop and mobile viewports in both color themes, run the probes, screenshot the perceptual long tail, and render a grouped HTML report with block/warn/nit findings. ## Quick Start Inspect the rendered frontend pages for visual defects like stray scrollbars, misalignment, and off-canvas elements, then report the findings grouped by severity.

Frequently Asked Questions about ava-qa-inspection

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

FAQPage Schema
How do I check a rendered web page for visual defects?▼

Navigate to each route in a real browser, inject a read-only probe script that measures overflow, empty boxes, misaligned sibling edges, duplicate controls, and off-canvas elements, then screenshot the page for perceptual issues. Confirm each probe hit is a real defect before reporting it with selector and pixel evidence.

What visual bugs do jsdom tests miss?▼

jsdom always returns zero for getBoundingClientRect, so it can assert a button exists but never that it is placed correctly. It misses misalignment, stray scrollbars, clipped overflow, empty styled blocks, and elements bleeding off-canvas, which only appear in a real rendered layout.

How do I turn a visual bug finding into an automated check?▼

Source-visible defects like wrong casing become ESLint rules or no-restricted-syntax selectors that block at PR. Rendered-DOM defects like alignment or duplicate controls become Playwright assertions using page and frontend process fixtures, reusing the same probe logic that found the defect.

Can automated QA inspection click buttons or submit forms?▼

No, the inspection is strictly read-only against production. Allowed actions are navigating, screenshotting, accessibility snapshots, evaluating read-only scripts, hovering, and scrolling; clicking anything that mutates state such as spawn, delete, or form submits is forbidden.

Why do probe results still need human-style judgment?▼

Probe hits are evidence, not verdicts, because some overflow or repeated controls are intentional, such as per-row actions or scrollable table containers. Each candidate must be confirmed against the checklist's severity floors and negative-sample discipline before being reported.