pdf

PDF - Document Production Workbench

Script Path Setup (MANDATORY before any script call)

All paths are relative to $PDF_SKILL_DIR. Resolve it once before calling any script:

PDF_SKILL_DIR="<skill_directory>"   # ← parent directory of this SKILL.md

For Python imports (when generation code needs to import skill modules):

import sys, os
PDF_SKILL_DIR = "<skill_directory>"
_scripts = os.path.join(PDF_SKILL_DIR, "scripts")
if _scripts not in sys.path:
    sys.path.insert(0, _scripts)

Triage

Determine task weight to control how much context to load:

Weight	Triggers	What to Load
Light	Format conversion, form fill, text extract, merge/split, simple certificate	SKILL.md + briefs/process.md only
Standard	Multi-page report, poster, academic paper, resume, reformat - any document with design decisions	SKILL.md + configs/fonts.md + matched brief + ALL files referenced by the brief (typesetting, configs, etc.)

⚠️ Pre-Routing Checks (run BEFORE matching brief)

1. Emoji Check - Scan user content for intentional emoji (decorative 📊🎯🔥, not OS-level emoji input). If found → force Creative pipeline (Fixed-Canvas or Flow depending on document type) regardless of original routing. ReportLab renders emoji as □ squares; LaTeX drops them entirely.
2. CJK Check - Chinese/Japanese/Korean content needs font coverage. Report brief must register CJK fonts - probe first with ls /usr/share/fonts/truetype/chinese/ (Linux) or check $FONT_DIR (macOS) to confirm which fonts exist, then register accordingly (prefer NotoSerifSC > Noto Sans SC; never hardcode a font name without verifying it exists). Creative Fixed-Canvas and Creative Flow briefs must load Google Fonts Noto Sans SC with font-display: swap; Academic brief must use \usepackage{ctex}.
3. Size Check - Non-standard page sizes (not A4/Letter/A3) → prefer Creative brief (Playwright handles any dimension). ReportLab can do custom sizes but pagination is manual.
4. Character Safety Check - Before writing any content string, scan for Japanese kana (の、が、は etc.), unusual Unicode symbols, or non-CJK characters that may corrupt during encoding transit ( Especially when code is written via heredoc/base64/LLM output). Replace with plain Chinese equivalents: の→之/的/缔, 々→omit or write full character. If content must preserve Japanese, use only standard CJK Unified Ideographs (U+4E00-U+9FFF) and common kana; avoid rare/private-use codepoints.