Run any Skill in Manus with one click

pdf-diff

Stars5

Forks0

UpdatedMarch 27, 2026 at 14:15

Visual PDF regression test comparing current Beamer output against a baseline branch. Use when checking if slide changes introduced visual regressions.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

alohays

alohays/paper2pr

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software Quality Assurance Analysts and TestersComputer and Mathematical Occupations·SOC 15-1253

SKILL.md

readonly

name	pdf-diff
description	Visual PDF regression test comparing current Beamer output against a baseline branch. Use when checking if slide changes introduced visual regressions.
argument-hint	[PaperName] [branch, default: main]
allowed-tools	["Read","Bash","Glob"]

Visual PDF Regression Test

Compare the current Beamer PDF output against a baseline branch to detect visual regressions.

Prerequisites

diff-pdf must be installed (brew install diff-pdf)
The paper's .tex file must compile successfully

Steps

Step 1: Parse arguments

First argument: PaperName (required, e.g., SUNY, DreamZero)
Second argument: baseline branch (optional, default: main)

Step 2: Compile current version

cd /Users/iyunseong/maangeek/paper2pr/Slides
TEXINPUTS=../Preambles:$TEXINPUTS xelatex -interaction=nonstopmode $PAPER.tex
cp $PAPER.pdf /tmp/${PAPER}_current.pdf

Step 3: Get baseline version

cd /Users/iyunseong/maangeek/paper2pr
git stash --include-untracked
git checkout $BRANCH -- Slides/$PAPER.tex
cd Slides
TEXINPUTS=../Preambles:$TEXINPUTS xelatex -interaction=nonstopmode $PAPER.tex
cp $PAPER.pdf /tmp/${PAPER}_baseline.pdf
git checkout - -- Slides/$PAPER.tex
git stash pop

Step 4: Run diff-pdf

diff-pdf --output-diff=/tmp/${PAPER}_diff.pdf /tmp/${PAPER}_baseline.pdf /tmp/${PAPER}_current.pdf
echo "Exit code: $?"

Exit code 0: PDFs are visually identical
Exit code 1: Visual differences detected (diff PDF saved)

Step 5: Report results

If identical: "No visual regressions detected."
If different: "Visual differences found. Diff PDF saved to /tmp/${PAPER}_diff.pdf"
- Open the diff PDF: open /tmp/${PAPER}_diff.pdf
- Differences are highlighted in red

Step 6: Cleanup

rm -f /tmp/${PAPER}_current.pdf /tmp/${PAPER}_baseline.pdf

Keep the diff PDF for review if differences were found.

Notes

This compares full visual output, including fonts, spacing, and figure rendering
Single-pass XeLaTeX is sufficient for visual comparison (no bibtex needed)
For multi-page diffs, diff-pdf --skip-identical shows only changed pages

More from this repository

same repository

compile-latex

alohays/paper2pr

Compile a Beamer LaTeX slide deck with XeLaTeX (3 passes + bibtex). Use when compiling lecture slides.

2026-03-275

deploy

alohays/paper2pr

Render Quarto slides and deploy to GitHub Pages via CI/CD. Use when deploying lecture slides after making changes.

2026-03-165

write-speaker-notes

alohays/paper2pr

Generate speaker notes (presentation script) for Quarto RevealJS slides. Supports English and Korean. Use when user asks to "write speaker notes", "add presentation script", "speaker script", "발표 스크립트", or "스피커 노트".

2026-03-155

extract-tikz

alohays/paper2pr

Extract TikZ diagrams from Beamer source, compile to PDF, convert to SVG with 0-based indexing. Use when updating TikZ diagrams for Quarto slides.

2026-03-155

qa-quarto

alohays/paper2pr

Adversarial Quarto vs Beamer QA. Critic finds issues, fixer applies fixes, loops until APPROVED (max 5 rounds).

2026-03-155

review-paper

alohays/paper2pr

Comprehensive manuscript review covering argument structure, technical methodology, citation completeness, and potential referee objections

2026-03-155

name	pdf-diff
description	Visual PDF regression test comparing current Beamer output against a baseline branch. Use when checking if slide changes introduced visual regressions.
argument-hint	[PaperName] [branch, default: main]
allowed-tools	["Read","Bash","Glob"]

Visual PDF Regression Test

Compare the current Beamer PDF output against a baseline branch to detect visual regressions.

Prerequisites

diff-pdf must be installed (brew install diff-pdf)
The paper's .tex file must compile successfully

Steps

Step 1: Parse arguments

First argument: PaperName (required, e.g., SUNY, DreamZero)
Second argument: baseline branch (optional, default: main)

Step 2: Compile current version

cd /Users/iyunseong/maangeek/paper2pr/Slides
TEXINPUTS=../Preambles:$TEXINPUTS xelatex -interaction=nonstopmode $PAPER.tex
cp $PAPER.pdf /tmp/${PAPER}_current.pdf

Step 3: Get baseline version

cd /Users/iyunseong/maangeek/paper2pr
git stash --include-untracked
git checkout $BRANCH -- Slides/$PAPER.tex
cd Slides
TEXINPUTS=../Preambles:$TEXINPUTS xelatex -interaction=nonstopmode $PAPER.tex
cp $PAPER.pdf /tmp/${PAPER}_baseline.pdf
git checkout - -- Slides/$PAPER.tex
git stash pop

Step 4: Run diff-pdf

diff-pdf --output-diff=/tmp/${PAPER}_diff.pdf /tmp/${PAPER}_baseline.pdf /tmp/${PAPER}_current.pdf
echo "Exit code: $?"

Exit code 0: PDFs are visually identical
Exit code 1: Visual differences detected (diff PDF saved)

Step 5: Report results

If identical: "No visual regressions detected."
If different: "Visual differences found. Diff PDF saved to /tmp/${PAPER}_diff.pdf"
- Open the diff PDF: open /tmp/${PAPER}_diff.pdf
- Differences are highlighted in red

Step 6: Cleanup

rm -f /tmp/${PAPER}_current.pdf /tmp/${PAPER}_baseline.pdf

Keep the diff PDF for review if differences were found.

Notes

This compares full visual output, including fonts, spacing, and figure rendering
Single-pass XeLaTeX is sufficient for visual comparison (no bibtex needed)
For multi-page diffs, diff-pdf --skip-identical shows only changed pages