Agent skill

Visual Audit

by pedrohcgs in pedrohcgs/claude-code-my-workflow

Adversarial visual-layout audit of a Quarto .qmd or Beamer .tex deck.

MITAuto-check: notesDocuments & Office

Install Visual Audit

skills CLI
$ npx skills add pedrohcgs/claude-code-my-workflow --skill visual-audit -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pedrohcgs/claude-code-my-workflow visual-audit --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pedrohcgs/claude-code-my-workflow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/visual-audit .claude/skills/visual-audit && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
visual-audit
GitHub stars
1.6k
Token cost
~651 tokens
SKILL.md length
284 words
Files
1
Skills in repo
59
Repo updated
First seen
Licence
MIT

At a glance

Adversarial visual-layout audit of a Quarto .qmd or Beamer .tex deck.

  • Works in 6 steps: Read the slide file specified in… → For Quarto (.qmd) files → For Beamer (.tex) files → …
  • User says visual audit
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Check the layout

What it does

Visual Audit is an agent skill from pedrohcgs/claude-code-my-workflow. 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.

Its SKILL.md is about 650 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office, covering LaTeX, Slides and decks and Copy editing and proofreading. It works with Python. The repository describes itself as: A ready-to-fork Claude Code template for academics using LaTeX/Beamer + R. Multi-agent review, quality gates, adversarial QA, and replication protocols. The licence is MIT.

When your agent uses it

  • User says visual audit
  • Check the layout
  • Does this overflow?
  • Look for visual issues

Example prompts

  • “visual audit”
  • “check the layout”
  • “does this overflow?”
  • “/visual-audit”

Requirements

  • Pre-approved tools (allowed-tools): Read, Grep, Glob, Write, Bash

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Read the slide file specified in $ARGUMENTS
  2. For Quarto (.qmd) files
  3. For Beamer (.tex) files
  4. Audit every slide for
  5. Produce a report organized by slide with severity and recommendations
  6. Follow the spacing-first principle

What it can do on your machine

Read from SKILL.md and the folder at commit ae72617. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Grep
    • Glob
    • Write
    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Visual Audit loads about 651 tokens when it runs. Until then it costs about 103 tokens; SKILL.md has 284 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~103
When it runs · the whole SKILL.md, loaded when a task matches
~651

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Grep, Glob, Write, Bash

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from pedrohcgs/claude-code-my-workflow at commit ae72617, republished under its MIT licence (© pedrohcgs). 284 words, ~651 tokens.

Download SKILL.mdSave it as .claude/skills/visual-audit/SKILL.md (or your agent's skills folder).
name
visual-audit
description
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`.
allowed-tools
Read, Grep, Glob, Write, Bash
argument-hint
[QMD or TEX filename]
disallowed-tools
Edit, MultiEdit

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
    • Measure the render: "${SLIDE_QA_PYTHON:-python3}" scripts/slide-qa.py Quarto/<deck>.html. It loads the deck in headless Chrome with every fragment shown and writes quality_reports/audits/slide-qa/<deck>/report.md — per-slide pixels past each edge, the offending element, content hidden inside scrolling elements — plus one screenshot per slide, and broken images or local files whose path is missing or in the wrong letter case (these break on GitHub Pages). OVERFLOW findings come from this report, and a broken or wrong-case asset is a finding too; Read the screenshots of flagged and dense slides for the other checks.
    • If it exits 2 (usually Playwright is missing — the script prints the one-time venv install and the SLIDE_QA_PYTHON line to set), say so, fall back to reading the rendered HTML of the dense slides and any screenshot the user supplies, and name the slides the user should eyeball
  3. For Beamer (.tex) files:

    • Compile (see /compile-latex), check the log for overfull hbox warnings, and Read the PDF pages that carry figures or dense content
  4. Audit every slide for:

    OVERFLOW: Content exceeding slide boundaries FONT CONSISTENCY: Inline font-size overrides, inconsistent sizes BOX FATIGUE: 3+ colored boxes on one slide (INV-7 allows two), 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)

© pedrohcgs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/visual-audit of pedrohcgs/claude-code-my-workflow.

Open the folder on GitHubat commit ae72617

Compare with similar skills

Visual Audit next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Visual Audit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Visual Audit this skillpedrohcgs/claude-code-my-workflow1.6k—~651Automated safety check: NotesMIT
BeamerNoi1r/beamer-skill364—~13kAutomated safety check: NotesMIT
Ambiguity Reportlawve-ai/awesome-legal-skills836—~4.6kAutomated safety check: PassApache-2.0
Compiledeckscunning1975/MixtapeTools4702 repos~3.1kAutomated safety check: PassNone
Mathmodel SkillhandsomeZR-netizen/mathmodel-skill292—~2.5kAutomated safety check: PassMIT
Literature Surveyai4s-research/ai4s-skills2372 repos~2kAutomated safety check: PassMIT

Similar skills

  • Beamer

    Noi1r/beamer-skill

    Beamer LaTeX slide workflow: create, compile, review, and polish academic presentations.

    364 GitHub stars~13k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check: notes
  • Ambiguity Report

    lawve-ai/awesome-legal-skills

    Turn an interpretive-ambiguity audit of a legal text — contract, statute, regulation, or judicial opinion — into a polished deliverable.

    836 GitHub stars~4.6k tokensUpdated 6 days ago
    Documents & OfficeAuto-check passed
  • Compiledeck

    scunning1975/MixtapeTools

    Create and compile beautiful Beamer presentations following the Rhetoric of Decks philosophy.

    470 GitHub starsUsed in 2 repos~3.1k tokens
    Documents & OfficeAuto-check passed
  • Mathmodel Skill

    handsomeZR-netizen/mathmodel-skill

    CUMCM 国赛、MCM/ICM 美赛与电工杯数学建模竞赛的端到端协作工作流。Use when a user explicitly works on one of these modeling contests or asks to run/review a modeling-competition paper from problem selection through modeling…

    292 GitHub stars~2.5k tokensUpdated 12 days ago
    Documents & OfficeAuto-check passed
  • Literature Survey

    ai4s-research/ai4s-skills

    A skill your agent uses when the user wants a comprehensive literature survey on a specific research topic.

    237 GitHub starsUsed in 2 repos~2k tokens
    Documents & OfficeAuto-check passed
  • Scientific Slides

    K-Dense-AI/claude-scientific-writer

    Build slide decks and presentations for research talks. An agent skill from K-Dense-AI/claude-scientific-writer.

    2.4k GitHub starsUsed in 15 repos~5.4k tokens
    Documents & OfficeAuto-check: notes

More from pedrohcgs/claude-code-my-workflow

All 59 skills in this repo
  • Devils Advocate

    pedrohcgs/claude-code-my-workflow

    Adversarial 5-7 question challenge to a deck's pedagogical choices — ordering, prerequisites, cognitive load, motivation.

    1.6k GitHub starsUsed in 2 repos~641 tokens
    Auto-check passed
  • Vaccinate

    pedrohcgs/claude-code-my-workflow

    Qualify a check before it is allowed to clear anything — prove it can detect the failure it is meant to catch.

    1.6k GitHub stars~2.1k tokensUpdated 11 days ago
    Auto-check: notes
  • Compile Latex

    pedrohcgs/claude-code-my-workflow

    Compile a Beamer LaTeX slide deck with XeLaTeX (3 passes + bibtex).

    1.6k GitHub starsUsed in 1 repo~492 tokens
    Auto-check: notes
  • Context Status

    pedrohcgs/claude-code-my-workflow

    Show current context status and session health. An agent skill from pedrohcgs/claude-code-my-workflow.

    1.6k GitHub starsUsed in 1 repo~613 tokens
    Auto-check: notes
  • Disclosure Check

    pedrohcgs/claude-code-my-workflow

    Pre-screen analysis outputs (tables, figures, logs) built on restricted or confidential data for statistical-disclosure-limitation problems before any release.

    1.6k GitHub starsUsed in 1 repo~2.6k tokens
    Auto-check: notes
  • Stata Replication

    pedrohcgs/claude-code-my-workflow

    End-to-end Stata replication pipeline — scaffolds numbered .do files in scripts/stata/, executes them via the stata-mcp MCP server, captures logs and outputs to output/, and produces…

    1.6k GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check: notes

Works with

Questions about Visual Audit

What does Visual Audit do?

Adversarial visual-layout audit of a Quarto .qmd or Beamer .tex deck. Visual Audit is an agent skill from pedrohcgs/claude-code-my-workflow.tex deck.

When should I use Visual Audit?

Visual Audit fits situations like: user says visual audit; check the layout; does this overflow?; look for visual issues.

How do I install Visual Audit in Claude Code?

Run `npx skills add pedrohcgs/claude-code-my-workflow --skill visual-audit -a claude-code`. Or copy the skill folder (.claude/skills/visual-audit in pedrohcgs/claude-code-my-workflow) into .claude/skills/visual-audit in your project. Claude Code loads it when a task matches its description.

How do I install Visual Audit in Codex?

Run `npx skills add pedrohcgs/claude-code-my-workflow --skill visual-audit -a codex`. Or copy the skill folder (.claude/skills/visual-audit in pedrohcgs/claude-code-my-workflow) into .agents/skills/visual-audit in your project. Codex loads it when a task matches its description.

Can I use Visual Audit in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pedrohcgs/claude-code-my-workflow --skill visual-audit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/visual-audit, .gemini/skills/visual-audit, .github/skills/visual-audit and .opencode/skills/visual-audit in your project.

What does Visual Audit need to run?

SKILL.md names no scripts, command-line tools or credentials: Visual Audit is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Grep, Glob, Write, Bash.

Does Visual Audit access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Visual Audit safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Visual Audit use?

Visual Audit is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Visual Audit use?

About 651 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Visual Audit?

Skills that share tags, products or a category with Visual Audit: Beamer (Noi1r/beamer-skill, 364 stars), Ambiguity Report (lawve-ai/awesome-legal-skills, 836 stars), Compiledeck (scunning1975/MixtapeTools, 470 stars) and Mathmodel Skill (handsomeZR-netizen/mathmodel-skill, 292 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Visual Audit?

pedrohcgs (a GitHub user) maintains it in pedrohcgs/claude-code-my-workflow, which has 1,645 GitHub stars. The repository holds 59 skills in this directory. The repository was last updated on September 27, 2026.

Source: pedrohcgs/claude-code-my-workflow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.