pdf-paginatedlisted
Install: claude install-skill slogsdon/skills-design
# Skill: pdf-paginated
Paginated document PDF via headless Chromium `page.pdf({format, margin})`. No
`.canvas` targeting — the whole document flows across paper pages. A folio footer
(title left, `page X / Y` right, JetBrains Mono) is rendered in the bottom margin.
## When to use
- Long-form documents where the reader expects pages: an essay, a field guide, a
spec, a report body, a letter.
- When the output should be Letter or A4 with real margins and page numbers, not a
single tall canvas.
Skip if:
- The artifact is a fixed-size design canvas (social post, business card, blog
hero, audit-report canvas). Use `pdf-html` — it sizes the PDF to the canvas.
- You want a PNG. Use `screenshot-html`.
## The HTML it expects
Plain document-flow HTML, NOT the `.canvas` convention:
- Content flows normally (`body` → `article`). No fixed-width `.canvas` wrapper.
- Give the reading column a measure with `max-width` (e.g. `64ch`) centered, and
put the page surface color on `body` (it prints because `printBackground` is on).
- **Do not set `@page` size/margins in CSS** — the script owns paper size and
margins via `--format` / `--margin`. A CSS `@page` margin would double up.
- Optional `@media print` rules to keep things tidy across page breaks:
`h2, li { break-inside: avoid; }` and `h2 { break-after: avoid; }`.
- Set a clean `<title>` — it becomes the footer's running head.
- Self-contained styles (inline `<style>` or a resolvable `@import`); web fonts
load fine (the s