AGENT SKILL

minimax-pdf

Use this skill when visual quality and design identity matter for a PDF. CREATE (generate from scratch): "make a PDF", "generate a report", "write a proposal", "create a resume", "beautiful PDF", "professional document", "cover page", "polished PDF", "client-ready document". FILL (complete form fields): "fill in the form", "fill out this PDF", "complete the form fields", "write values into PDF", "what fields does this PDF have". REFORMAT (apply design to an existing doc): "reformat this document", "apply our style", "convert this Markdown/text to PDF", "make this doc look good", "re-style this PDF". This skill uses a token-based design system: color, typography, and spacing are derived from the document type and flow through every page. The output is print-ready. Prefer this skill when appearance matters, not just when any PDF output is needed.

License 许可
MIT
最近更新
2026-11-10
Stars
★ 1
Forks
0

01 前言 Front Matter

name
minimax-pdf
license
MIT
version
1.0.0
metadata
{ "version": "1.0", "category": "document-generation" }
description
Use this skill when visual quality and design identity matter for a PDF. CREATE (generate from scratch): "make a PDF", "generate a report", "write a proposal", "create a resume", "beautiful PDF", "professional document", "cover page", "polished PDF", "client-ready document". FILL (complete form fields): "fill in the form", "fill out this PDF", "complete the form fields", "write values into PDF", "what fields does this PDF have". REFORMAT (apply design to an existing doc): "reformat this document", "apply our style", "convert this Markdown/text to PDF", "make this doc look good", "re-style this PDF". This skill uses a token-based design system: color, typography, and spacing are derived from the document type and flow through every page. The output is print-ready. Prefer this skill when appearance matters, not just when any PDF output is needed.
description_en
Generate high-quality designed PDF documents
description_zh
高质量 PDF 文档生成

02 资源文件 11

03 SKILL.md 正文

minimax-pdf

Three tasks. One skill.

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


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.

bash 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

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."}]}

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.

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

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


Environment

bash scripts/make.sh check   # verify all deps
bash scripts/make.sh fix     # auto-install missing deps
bash scripts/make.sh 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
Node.js 18+ render_cover.js system
playwright + Chromium render_cover.js npm install -g playwright && npx playwright install chromium

04 同仓库更多 Skills

YYC-Cube
YYC-Cube/YYC3-Knowledge-Base

vercel-sandbox

Run agent-browser + Chrome inside Vercel Sandbox microVMs for browser automation from any Vercel-deployed app. Use when the user needs browser automation in a Vercel app (Next.js, SvelteKit, Nuxt, Remix, Astro, etc.), wants to run headless Chrome without binary size limits, needs persistent browser sessions across commands, or wants ephemeral isolated browser environments. Triggers include "Vercel Sandbox browser", "microVM Chrome", "agent-browser in sandbox", "browser automation on Vercel", or any task requiring Chrome in a Vercel Sandbox.

★ 1
YYC-Cube
YYC-Cube/YYC3-Knowledge-Base

slack

Interact with Slack workspaces using browser automation. Use when the user needs to check unread channels, navigate Slack, send messages, extract data, find information, search conversations, or automate any Slack task. Triggers include "check my Slack", "what channels have unreads", "send a message to", "search Slack for", "extract from Slack", "find who said", or any task requiring programmatic Slack interaction.

★ 1
YYC-Cube
YYC-Cube/YYC3-Knowledge-Base

electron

Automate Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify, etc.) using agent-browser via Chrome DevTools Protocol. Use when the user needs to interact with an Electron app, automate a desktop app, connect to a running app, control a native app, or test an Electron application. Triggers include "automate Slack app", "control VS Code", "interact with Discord app", "test this Electron app", "connect to desktop app", or any task requiring automation of a native Electron application.

★ 1
YYC-Cube
YYC-Cube/YYC3-Knowledge-Base

dogfood

Systematically explore and test a web application to find bugs, UX issues, and other problems. Use when asked to "dogfood", "QA", "exploratory test", "find issues", "bug hunt", "test this app/site/platform", or review the quality of a web application. Produces a structured report with full reproduction evidence -- step-by-step screenshots, repro videos, and detailed repro steps for every issue -- so findings can be handed directly to the responsible teams.

★ 1
YYC-Cube
YYC-Cube/YYC3-Knowledge-Base

agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.

★ 1
YYC-Cube
YYC-Cube/YYC3-Knowledge-Base

shadcn

Manages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI, including chat interfaces. Provides project context, component docs, and usage examples. Applies when working with shadcn/ui, component registries, presets, --preset codes, or any project with a components.json file. Also triggers for "shadcn init", "create an app with --preset", "switch to --preset", and for building a design system or applying a DESIGN.md or brand spec to shadcn/ui.

★ 1