pedrohcgs

visual-audit

Adversarial visual-layout audit of a Quarto `.qmd` or Beamer `.tex` deck. Flags overflow, font inconsistency, box fatigue, spacing, and alignment issues. Use when user says "visual audit", "check the layout", "does this overflow?", "look for visual issues", "audit the slides", or after reworking a deck's appearance. Does NOT check writing or pedagogy — pair with `/proofread` or `/pedagogy-review`.

pedrohcgs 1,544 2,983 Updated 2w ago
GitHub

Install

npx skillscat add pedrohcgs/claude-code-my-workflow/visual-audit

Install via the SkillsCat registry.

About this skill

Performs a visual layout audit of Quarto or Beamer slide decks to detect overflow, font inconsistencies, excessive colored boxes, spacing problems, and alignment issues. It is useful when checking whether a deck's content fits within slide boundaries before finalizing or after appearance revisions, complementing separate writing and pedagogy reviews.

SKILL.md

Visual Audit of Slide Deck

Perform a thorough visual layout audit of a slide deck.

Steps

  1. Read the slide 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. Audit every slide for:

    OVERFLOW: Content exceeding slide boundaries
    FONT CONSISTENCY: Inline font-size overrides, inconsistent sizes
    BOX FATIGUE: 2+ colored boxes on one slide, wrong box types
    SPACING: Missing negative margins, missing fig-align
    LAYOUT: Missing transitions, missing framing sentences, semantic colors

  5. Produce a report organized by slide with severity and recommendations

  6. 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)