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

  1. Work from the bronze source file. Do not overwrite it.
  2. If pypdf is unavailable, create a local virtualenv and install pypdf there instead of touching the system interpreter.
  3. Run python "${CODEX_HOME:-$HOME/.codex}/skills/normalize-id-scan-pdf/scripts/fix_id_scan_pdf.py" ... against the source PDF.
  4. Review the script output paths and geometry summary.
  5. 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.
  6. 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:

Installs
12
First Seen
May 17, 2026
normalize-id-scan-pdf — arthurzakirov/opportunityos