# Visual Audit

> Adversarial visual layout audit of documents and slides. Checks overflow, font consistency, component fatigue, and spacing. Supports .tex, .qmd, and .typ files.

- Skill: `clearsmog/visual-audit` (Agent Skill)
- Install (CLI): `npx skillmds@latest add clearsmog/visual-audit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/clearsmog/visual-audit/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: clearsmog (https://skillmd.com/u/clearsmog)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/clearsmog/visual-audit

---


# Visual Audit

Perform a thorough visual layout audit of any supported document. Routes to the `document-auditor` agent.

## Steps

1. **Read the file** specified in `$ARGUMENTS`

2. **For Quarto (.qmd) files:**
   - Render with `quarto render Quarto/$ARGUMENTS`
   - Open in browser to inspect each slide

3. **For Beamer (.tex) files:**
   - Compile and check for overfull hbox warnings

4. **For Typst (.typ) files:**
   - Compile with `typst compile FILENAME.typ`
   - Check for content overflow, component fatigue, typography consistency

5. **Audit every slide/page for:**

   **OVERFLOW:** Content exceeding boundaries
   **FONT CONSISTENCY:** Inline font-size overrides, inconsistent sizes
   **COMPONENT FATIGUE:** 2+ colored boxes/callouts on one slide/page, wrong types
   **SPACING:** Missing margins, missing alignment
   **LAYOUT:** Missing transitions, missing framing sentences, semantic colors

6. **Produce a report** organized by slide/page with severity and recommendations

7. **Follow the spacing-first principle:**
   1. Reduce vertical spacing with negative margins
   2. Consolidate lists
   3. Move displayed equations inline
   4. Reduce image/SVG size
   5. Last resort: font size reduction (never below 0.85em)