Pdf

pdf

Three tasks. One skill.

Environment and delivery

Set SKILL_DIR to the absolute directory containing this file (the pdf/ subdirectory of the Office package). Resolve reference paths relative to it.

Run bash "$SKILL_DIR/scripts/make.sh" check once per session before CREATE/REFORMAT. It verifies an actual Chromium launch. If needed, install dependencies with bash "$SKILL_DIR/scripts/make.sh" fix in an activated Python virtual environment; on Linux, Chromium may also need npx playwright install-deps chromium. FILL and read-only inspection need Python and pypdf, not the browser pipeline. Read only the guide and scripts relevant to the selected route. Explicit user or template formatting takes precedence over the design defaults.

For a user-requested rendered preview or visual review, use pdftoppm -png -r 120 output.pdf preview/page (create preview/ first) and inspect the images.

Read design/design.md before any CREATE or REFORMAT work.

Route table

Rule: when in doubt between CREATE and REFORMAT, ask whether the user has an existing document to start from. If yes → REFORMAT. If no → CREATE.

Route A: CREATE

Full pipeline — content → design tokens → cover → body → merged PDF.

bashCopy code
bash "$SKILL_DIR/scripts/make.sh" run \
  --title "Q3 Strategy Review" --type proposal \
  --author "Strategy Team" --date "October 2025" \
  --accent "#2D5F8A" \
  --content content.json --out report.pdf

Doc types: report · proposal · resume · portfolio · academic · general · minimal · stripe · diagonal · frame · editorial · magazine · darkroom · terminal · poster

Cover extras (inject into tokens via --abstract, --cover-image):

• --abstract "text" — abstract text block on the cover (magazine/darkroom)
• --cover-image "url" — hero image URL/path (magazine, darkroom, poster)

Color overrides — always choose these based on document content:

• --accent "#HEX" — override the accent color; accent_lt is auto-derived by lightening toward white
• --cover-bg "#HEX" — override the cover background color

Accent color selection guidance:

You have creative authority over the accent color. Pick it from the document's semantic context — title, industry, purpose, audience — not from generic "safe" choices. The accent appears on section rules, callout bars, table headers, and the cover: it carries the document's visual identity.

Rule: choose a color that a thoughtful designer would select for this specific document — not the type's default. Muted, desaturated tones work best; avoid vivid primaries. When in doubt, go darker and more neutral.

content.json block types:

chart / flowchart schemas:

jsonCopy code
{"type":"chart","chart_type":"bar","labels":["Q1","Q2","Q3","Q4"],
 "datasets":[{"label":"Revenue","values":[120,145,132,178]}],"caption":"Q results"}

{"type":"flowchart",
 "nodes":[{"id":"s","label":"Start","shape":"oval"},
          {"id":"p","label":"Process","shape":"rect"},
          {"id":"d","label":"Valid?","shape":"diamond"},
          {"id":"e","label":"End","shape":"oval"}],
 "edges":[{"from":"s","to":"p"},{"from":"p","to":"d"},
          {"from":"d","to":"e","label":"Yes"},{"from":"d","to":"p","label":"No"}]}

{"type":"bibliography","items":[
  {"id":"1","text":"Author (Year). Title. Publisher."}]}

Route B: FILL

Fill form fields in an existing PDF without altering layout or design.

bashCopy code
# Step 1: inspect
python3 "$SKILL_DIR/scripts/fill_inspect.py" --input form.pdf

# Step 2: fill
python3 "$SKILL_DIR/scripts/fill_write.py" --input form.pdf --out filled.pdf \
  --values '{"FirstName": "Jane", "Agree": "true", "Country": "US"}'

Always run fill_inspect.py first to get exact field names.

Route C: REFORMAT

Parse an existing document → content.json → CREATE pipeline.

bashCopy code
bash "$SKILL_DIR/scripts/make.sh" reformat \
  --input source.md --title "My Report" --type report --out output.pdf

Supported input formats: .md .txt .pdf .json

Environment

bashCopy code
bash "$SKILL_DIR/scripts/make.sh" check   # verify all deps
bash "$SKILL_DIR/scripts/make.sh" fix     # auto-install missing deps
bash "$SKILL_DIR/scripts/make.sh" demo    # build a sample PDF