visual-audit

Solid

Perform adversarial visual audit of Quarto RevealJS slides checking for density violations, overflow, font consistency, box fatigue, and centering issues, on full-deck screenshots from scripts/shoot_slides.py.

Code & Development 5 stars 1 forks Updated today MIT

Install

View on GitHub

Quality Score: 80/100

Stars 20%
26
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Visual Audit of Slide Deck Perform a thorough visual layout audit of a slide deck, on the source and on the rendered pixels. ## Steps 1. **Resolve the deck** named in `$ARGUMENTS` and load its premises: ```bash python3 scripts/deckpath.py $ARGUMENTS --field qmd # the source python3 scripts/deckprofile.py $ARGUMENTS # resolved profile JSON cat "$(python3 scripts/deckpath.py $ARGUMENTS --field config)" # <deck>.deck.yml ``` The density numbers below come from the profile JSON (`bullets_max`, `bullets_max_with_figure`, `bullets_max_two_line`, `box_density`, `max_nesting`); quote the deck's own budget in every density finding. 2. **Determine the ruleset:** - Main theme (`clean-academic.scss`) -> full design-principles audit (`.claude/rules/slide-design-principles.md`) - Legacy theme (`clean-academic-legacy.scss`) or SUNY's own theme -> legacy audit only (overflow, spacing); skip density limits 3. **Screenshot every slide:** ```bash python3 scripts/shoot_slides.py $ARGUMENTS --out /tmp/$ARGUMENTS-shots ``` This renders the html first when it is missing or older than the qmd, then writes one 1280x720 PNG per slide in reading order (vertical stacks included). Read every PNG - the pixels catch what the source hides: real overflow, wrapped bullets, a figure that failed to load, a video slide stuck on a black frame. (`bash scripts/preview.sh <name>` still opens the deck in a br...

Details

Author
alohays
Repository
alohays/paper2pr
Created
5 months ago
Last Updated
today
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category