normalize-id-scan-pdf
Installation
SKILL.md
Normalize ID Scan PDF
Overview
Turn a bad ID scan PDF into a readable, portable output PDF. Prefer a deterministic transform plus autonomous validation over ad hoc manual tweaking.
Workflow
- Work from the bronze source file. Do not overwrite it.
- If
pypdfis unavailable, create a local virtualenv and installpypdfthere instead of touching the system interpreter. - Run
python "${CODEX_HOME:-$HOME/.codex}/skills/normalize-id-scan-pdf/scripts/fix_id_scan_pdf.py" ...against the source PDF. - Review the script output paths and geometry summary.
- If the output still clips or uses the page poorly, iterate from the bronze file again. Do not keep transforming the silver or gold output.
- After the PDF passes self-check, open the gold PDF locally for final human review if local browser or desktop open access is available. Prefer Chrome when it is installed and reachable.
Command Pattern
Use: