visual-audit
Visual Audit
Perform a thorough visual layout audit of any supported document. Routes to the document-auditor agent.
Steps
-
Read the file specified in
$ARGUMENTS -
For Quarto (.qmd) files:
- Render with
quarto render Quarto/$ARGUMENTS - Open in browser to inspect each slide
- Render with
-
For Beamer (.tex) files:
- Compile and check for overfull hbox warnings
-
For Typst (.typ) files:
- Compile with
typst compile FILENAME.typ - Check for content overflow, component fatigue, typography consistency
- Compile with
-
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
-
Produce a report organized by slide/page with severity and recommendations
-
Follow the spacing-first principle:
- Reduce vertical spacing with negative margins
- Consolidate lists
- Move displayed equations inline
- Reduce image/SVG size
- Last resort: font size reduction (never below 0.85em)
More from clearsmog/claude-skills
typst
Syntax guide and ecosystem reference for writing Typst (.typ) files. Use this skill when writing, editing, or debugging Typst documents. Covers core syntax, common errors, packages, and best practices.
11image-search
Search the web for images (photos, logos, graphics) and download them with Typst embedding code. Use when the user needs real-world images, company logos, or existing graphics for documents.
3compile
Compile any supported file type. Detects format (.typ, .qmd, .py) and runs appropriate build command.
2qa
Adversarial quality audit loop. Critic finds issues, fixer applies fixes, loops until APPROVED (max 5 rounds). Works with any document format.
2learn
|
2deploy
Render and deploy documents to output directory for hosting. Supports Quarto slides and Typst PDFs.
2