pdf
Three tasks. One skill.
Read design/design.md before any CREATE or REFORMAT work.
ZhiYuan/Pi execution
When this skill is run inside ZhiYuan, call run_skill_script for the bundled .py, .js,
and .sh pipeline steps. Pass each argument separately in args; do not call python3,
uv, or bash directly. The application chooses the managed Python/uv/Node/Git Bash runtime
and returns a structured runtime error instead of misreporting the input PDF as missing.
Example:
{
"skillId": "pdf",
"script": "scripts/fill_inspect.py",
"args": ["--input", "form.pdf"]
}
Route table
| User intent |
Route |
Scripts used |
| Generate a new PDF from scratch |
CREATE |
palette.py → cover.py → render_cover.js → render_body.py → merge.py |
| Fill / complete form fields in an existing PDF |
FILL |
fill_inspect.py → fill_write.py |
| Reformat / re-style an existing document |
REFORMAT |
reformat_parse.py → then full CREATE pipeline |
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.
python3 scripts/make.py 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
| Type |
Cover pattern |
Visual identity |
report |
fullbleed |
Dark bg, dot grid, Playfair Display |
proposal |
split |
Left panel + right geometric, Syne |
resume |
typographic |
Oversized first-word, DM Serif Display |
portfolio |
atmospheric |
Near-black, radial glow, Fraunces |
academic |
typographic |
Light bg, classical serif, EB Garamond |
general |
fullbleed |
Dark slate, Outfit |
minimal |
minimal |
White + single 8px accent bar, Cormorant Garamond |
stripe |
stripe |
3 bold horizontal color bands, Barlow Condensed |
diagonal |
diagonal |
SVG angled cut, dark/light halves, Montserrat |
frame |
frame |
Inset border, corner ornaments, Cormorant |
editorial |
editorial |
Ghost letter, all-caps title, Bebas Neue |
magazine |
magazine |
Warm cream bg, centered stack, hero image, Playfair Display |
darkroom |
darkroom |
Navy bg, centered stack, grayscale image, Playfair Display |
terminal |
terminal |
Near-black, grid lines, monospace, neon green |
poster |
poster |
White bg, thick sidebar, oversized title, Barlow Condensed |
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.
| Context |
Suggested accent range |
| Legal / compliance / finance |
Deep navy #1C3A5E, charcoal #2E3440, slate #3D4C5E |
| Healthcare / medical |
Teal-green #2A6B5A, cool green #3A7D6A |
| Technology / engineering |
Steel blue #2D5F8A, indigo #3D4F8A |
| Environmental / sustainability |
Forest #2E5E3A, olive #4A5E2A |
| Creative / arts / culture |
Burgundy #6B2A35, plum #5A2A6B, terracotta #8A3A2A |
| Academic / research |
Deep teal #2A5A6B, library blue #2A4A6B |
| Corporate / neutral |
Slate #3D4A5A, graphite #444C56 |
| Luxury / premium |
Warm black #1A1208, deep bronze #4A3820 |
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:
| Block |
Usage |
Key fields |
h1 |
Section heading + accent rule |
text |
h2 |
Subsection heading |
text |
h3 |
Sub-subsection (bold) |
text |
body |
Justified paragraph; supports <b> <i> markup |
text |
bullet |
Unordered list item (• prefix) |
text |
numbered |
Ordered list item — counter auto-resets on non-numbered blocks |
text |
callout |
Highlighted insight box with accent left bar |
text |
table |
Data table — accent header, alternating row tints |
headers, rows, col_widths?, caption? |
image |
Embedded image scaled to column width |
path/src, caption? |
figure |
Image with auto-numbered "Figure N:" caption |
path/src, caption? |
code |
Monospace code block with accent left border |
text, language? |
math |
Display math — LaTeX syntax via matplotlib mathtext |
text, label?, caption? |
chart |
Bar / line / pie chart rendered with matplotlib |
chart_type, labels, datasets, title?, x_label?, y_label?, caption?, figure? |
flowchart |
Process diagram with nodes + edges via matplotlib |
nodes, edges, caption?, figure? |
bibliography |
Numbered reference list with hanging indent |
items [{id, text}], title? |
divider |
Accent-colored full-width rule |
— |
caption |
Small muted label |
text |
pagebreak |
Force a new page |
— |
spacer |
Vertical whitespace |
pt (default 12) |
chart / flowchart schemas:
{"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."}]}
Optional preview
When a preview is useful or requested, render the PDF pages and contact sheet:
uv run --with pypdfium2 --with pillow python \
SKILL_DIR/scripts/pdf_preview.py final.pdf -o pdf-preview
This writes one PNG per page and contact-sheet.png. It does not score pages
or produce a validation report. Save the PDF and return its path to the user;
preview generation is not a delivery requirement.
Route B: FILL
Fill form fields in an existing PDF without altering layout or design.
# Step 1: inspect
python3 scripts/fill_inspect.py --input form.pdf
# Step 2: fill
python3 scripts/fill_write.py --input form.pdf --out filled.pdf \
--values '{"FirstName": "Jane", "Agree": "true", "Country": "US"}'
| Field type |
Value format |
text |
Any string |
checkbox |
"true" or "false" |
dropdown |
Must match a choice value from inspect output |
radio |
Must match a radio value (often starts with /) |
Always run fill_inspect.py first to get exact field names.
Route C: REFORMAT
Parse an existing document → content.json → CREATE pipeline.
python3 scripts/make.py reformat \
--input source.md --title "My Report" --type report --out output.pdf
Supported input formats: .md .txt .pdf .json
Environment
python3 scripts/make.py check # verify all deps
python3 scripts/make.py fix # auto-install missing deps
python3 scripts/make.py demo # build a sample PDF
| Tool |
Used by |
Install |
| Python 3.9+ |
all .py scripts |
system |
reportlab |
render_body.py |
pip install reportlab |
pypdf |
fill, merge, reformat |
pip install pypdf |
pypdfium2 + Pillow |
optional page previews |
uv run --with pypdfium2 --with pillow ... |
| Node.js 18+ |
render_cover.js |
system |
playwright + Chromium |
render_cover.js |
npm install -g playwright && npx playwright install chromium |
1---2name: minimax-pdf3description: >4 Use this skill when visual quality and design identity matter for a PDF.5 CREATE (generate from scratch): "make a PDF", "generate a report", "write a proposal",6 "create a resume", "beautiful PDF", "professional document", "cover page",7 "polished PDF", "client-ready document".8 FILL (complete form fields): "fill in the form", "fill out this PDF",9 "complete the form fields", "write values into PDF", "what fields does this PDF have".10 REFORMAT (apply design to an existing doc): "reformat this document", "apply our style",11 "convert this Markdown/text to PDF", "make this doc look good", "re-style this PDF".12 This skill uses a token-based design system: color, typography, and spacing are derived13 from the document type and flow through every page. The output is print-ready.14 Prefer this skill when appearance matters, not just when any PDF output is needed.15license: MIT16metadata:17 source: https://skillmd.com/skills/rongxinzy/minimax-pdf18 version: "1.0.1"19 category: document-generation20---2122# pdf2324Three tasks. One skill.2526## Read `design/design.md` before any CREATE or REFORMAT work.2728## ZhiYuan/Pi execution2930When this skill is run inside ZhiYuan, call `run_skill_script` for the bundled `.py`, `.js`,31and `.sh` pipeline steps. Pass each argument separately in `args`; do not call `python3`,32`uv`, or `bash` directly. The application chooses the managed Python/uv/Node/Git Bash runtime33and returns a structured runtime error instead of misreporting the input PDF as missing.3435Example:3637```json38{39 "skillId": "pdf",40 "script": "scripts/fill_inspect.py",41 "args": ["--input", "form.pdf"]42}43```4445---4647## Route table4849| User intent | Route | Scripts used |50|---|---|---|51| Generate a new PDF from scratch | **CREATE** | `palette.py` → `cover.py` → `render_cover.js` → `render_body.py` → `merge.py` |52| Fill / complete form fields in an existing PDF | **FILL** | `fill_inspect.py` → `fill_write.py` |53| Reformat / re-style an existing document | **REFORMAT** | `reformat_parse.py` → then full CREATE pipeline |5455**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.5657---5859## Route A: CREATE6061Full pipeline — content → design tokens → cover → body → merged PDF.6263```bash64python3 scripts/make.py run \65 --title "Q3 Strategy Review" --type proposal \66 --author "Strategy Team" --date "October 2025" \67 --accent "#2D5F8A" \68 --content content.json --out report.pdf69```7071**Doc types:** `report` · `proposal` · `resume` · `portfolio` · `academic` · `general` · `minimal` · `stripe` · `diagonal` · `frame` · `editorial` · `magazine` · `darkroom` · `terminal` · `poster`7273| Type | Cover pattern | Visual identity |74|---|---|---|75| `report` | `fullbleed` | Dark bg, dot grid, Playfair Display |76| `proposal` | `split` | Left panel + right geometric, Syne |77| `resume` | `typographic` | Oversized first-word, DM Serif Display |78| `portfolio` | `atmospheric` | Near-black, radial glow, Fraunces |79| `academic` | `typographic` | Light bg, classical serif, EB Garamond |80| `general` | `fullbleed` | Dark slate, Outfit |81| `minimal` | `minimal` | White + single 8px accent bar, Cormorant Garamond |82| `stripe` | `stripe` | 3 bold horizontal color bands, Barlow Condensed |83| `diagonal` | `diagonal` | SVG angled cut, dark/light halves, Montserrat |84| `frame` | `frame` | Inset border, corner ornaments, Cormorant |85| `editorial` | `editorial` | Ghost letter, all-caps title, Bebas Neue |86| `magazine` | `magazine` | Warm cream bg, centered stack, hero image, Playfair Display |87| `darkroom` | `darkroom` | Navy bg, centered stack, grayscale image, Playfair Display |88| `terminal` | `terminal` | Near-black, grid lines, monospace, neon green |89| `poster` | `poster` | White bg, thick sidebar, oversized title, Barlow Condensed |9091Cover extras (inject into tokens via `--abstract`, `--cover-image`):92- `--abstract "text"` — abstract text block on the cover (magazine/darkroom)93- `--cover-image "url"` — hero image URL/path (magazine, darkroom, poster)9495**Color overrides — always choose these based on document content:**96- `--accent "#HEX"` — override the accent color; `accent_lt` is auto-derived by lightening toward white97- `--cover-bg "#HEX"` — override the cover background color9899**Accent color selection guidance:**100101You 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.102103| Context | Suggested accent range |104|---|---|105| Legal / compliance / finance | Deep navy `#1C3A5E`, charcoal `#2E3440`, slate `#3D4C5E` |106| Healthcare / medical | Teal-green `#2A6B5A`, cool green `#3A7D6A` |107| Technology / engineering | Steel blue `#2D5F8A`, indigo `#3D4F8A` |108| Environmental / sustainability | Forest `#2E5E3A`, olive `#4A5E2A` |109| Creative / arts / culture | Burgundy `#6B2A35`, plum `#5A2A6B`, terracotta `#8A3A2A` |110| Academic / research | Deep teal `#2A5A6B`, library blue `#2A4A6B` |111| Corporate / neutral | Slate `#3D4A5A`, graphite `#444C56` |112| Luxury / premium | Warm black `#1A1208`, deep bronze `#4A3820` |113114**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.115116**content.json block types:**117118| Block | Usage | Key fields |119|---|---|---|120| `h1` | Section heading + accent rule | `text` |121| `h2` | Subsection heading | `text` |122| `h3` | Sub-subsection (bold) | `text` |123| `body` | Justified paragraph; supports `<b>` `<i>` markup | `text` |124| `bullet` | Unordered list item (• prefix) | `text` |125| `numbered` | Ordered list item — counter auto-resets on non-numbered blocks | `text` |126| `callout` | Highlighted insight box with accent left bar | `text` |127| `table` | Data table — accent header, alternating row tints | `headers`, `rows`, `col_widths`?, `caption`? |128| `image` | Embedded image scaled to column width | `path`/`src`, `caption`? |129| `figure` | Image with auto-numbered "Figure N:" caption | `path`/`src`, `caption`? |130| `code` | Monospace code block with accent left border | `text`, `language`? |131| `math` | Display math — LaTeX syntax via matplotlib mathtext | `text`, `label`?, `caption`? |132| `chart` | Bar / line / pie chart rendered with matplotlib | `chart_type`, `labels`, `datasets`, `title`?, `x_label`?, `y_label`?, `caption`?, `figure`? |133| `flowchart` | Process diagram with nodes + edges via matplotlib | `nodes`, `edges`, `caption`?, `figure`? |134| `bibliography` | Numbered reference list with hanging indent | `items` [{id, text}], `title`? |135| `divider` | Accent-colored full-width rule | — |136| `caption` | Small muted label | `text` |137| `pagebreak` | Force a new page | — |138| `spacer` | Vertical whitespace | `pt` (default 12) |139140**chart / flowchart schemas:**141```json142{"type":"chart","chart_type":"bar","labels":["Q1","Q2","Q3","Q4"],143 "datasets":[{"label":"Revenue","values":[120,145,132,178]}],"caption":"Q results"}144145{"type":"flowchart",146 "nodes":[{"id":"s","label":"Start","shape":"oval"},147 {"id":"p","label":"Process","shape":"rect"},148 {"id":"d","label":"Valid?","shape":"diamond"},149 {"id":"e","label":"End","shape":"oval"}],150 "edges":[{"from":"s","to":"p"},{"from":"p","to":"d"},151 {"from":"d","to":"e","label":"Yes"},{"from":"d","to":"p","label":"No"}]}152153{"type":"bibliography","items":[154 {"id":"1","text":"Author (Year). Title. Publisher."}]}155```156157### Optional preview158159When a preview is useful or requested, render the PDF pages and contact sheet:160161```bash162uv run --with pypdfium2 --with pillow python \163 SKILL_DIR/scripts/pdf_preview.py final.pdf -o pdf-preview164```165166This writes one PNG per page and `contact-sheet.png`. It does not score pages167or produce a validation report. Save the PDF and return its path to the user;168preview generation is not a delivery requirement.169170---171172## Route B: FILL173174Fill form fields in an existing PDF without altering layout or design.175176```bash177# Step 1: inspect178python3 scripts/fill_inspect.py --input form.pdf179180# Step 2: fill181python3 scripts/fill_write.py --input form.pdf --out filled.pdf \182 --values '{"FirstName": "Jane", "Agree": "true", "Country": "US"}'183```184185| Field type | Value format |186|---|---|187| `text` | Any string |188| `checkbox` | `"true"` or `"false"` |189| `dropdown` | Must match a choice value from inspect output |190| `radio` | Must match a radio value (often starts with `/`) |191192Always run `fill_inspect.py` first to get exact field names.193194---195196## Route C: REFORMAT197198Parse an existing document → content.json → CREATE pipeline.199200```bash201python3 scripts/make.py reformat \202 --input source.md --title "My Report" --type report --out output.pdf203```204205**Supported input formats:** `.md` `.txt` `.pdf` `.json`206207---208209## Environment210211```bash212python3 scripts/make.py check # verify all deps213python3 scripts/make.py fix # auto-install missing deps214python3 scripts/make.py demo # build a sample PDF215```216217| Tool | Used by | Install |218|---|---|---|219| Python 3.9+ | all `.py` scripts | system |220| `reportlab` | `render_body.py` | `pip install reportlab` |221| `pypdf` | fill, merge, reformat | `pip install pypdf` |222| `pypdfium2` + `Pillow` | optional page previews | `uv run --with pypdfium2 --with pillow ...` |223| Node.js 18+ | `render_cover.js` | system |224| `playwright` + Chromium | `render_cover.js` | `npm install -g playwright && npx playwright install chromium` |