audit_page
Analyze HTML/CSS for design quality: checks typography, accessibility, responsive patterns, style guide compliance, and visual rhythm. Returns pass/fail per check with fix instructions.
Instructions
Audit HTML/CSS against Raven's design quality standards. Checks typography (min 13px, weight 400+, modular-scale heading ratios, line-height consistency), accessibility (WCAG touch targets, alt text, contrast), responsive patterns (flexbox over grid, clamp sizing, max-width containers), style guide compliance (CSS custom properties, no bare hex), and visual rhythm (4/8px spacing grid, tight spacing scale, palette size). Pass containerMaxWidth (your design system's canonical container token, in px) to make the max-width check token-aware — it then flags containers that diverge from your system (too narrow OR too wide) instead of a generic 1200px heuristic. Returns pass/fail per check with specific fix instructions.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | If set, Raven launches headless chromium, renders the page, and audits the RENDERED DOM. | |
| html | No | The full HTML content of the page to audit | |
| strict | No | Strict mode — also flags warnings as failures. Default: false | |
| compact | No | Return only the decision-grade signal — score, grade, summary, errors, warnings, fix_priority — and drop the embedded base64 screenshot and the passes list (replaced by passes_count). Default false. Use when the full payload would blow the tool-result budget. | |
| viewport | No | ||
| interactions | No | Before capturing, fire each interaction in order (hover/click/focus the selector, then wait delay_ms). Captures the resulting dynamic state — e.g. an on-hover theme-toggle wash invisible to a static screenshot. | |
| scroll_settle | No | Before capturing, step through the page with short pauses so IntersectionObserver/whileInView reveals fire, then return to the top and settle. Also plays preload=none videos. Prevents blank-section false positives. | |
| containerMaxWidth | No | Your design system's canonical content-container width in px (e.g. 1152). When set, the responsive/max-width check flags divergence from this token instead of using the generic 1200px heuristic. | |
| adversarial_verify | No | After generating findings, independently re-check each against the live DOM/network and tag it confirmed / likely-artifact / inconclusive. Surfaces a debunked_count. |