Skip to content
Back to search

posterly

Build academic conference posters as a single HTML/CSS file, rendered to print-ready PDF via headless Chromium. A coding-agent skill.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026. Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Chenruishuo/posterly with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Chenruishuo/posterly'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/chenruishuo--posterly/badge.svg)](/listings/chenruishuo--posterly)

HTML

<a href="/listings/chenruishuo--posterly"><img src="/api/listings/chenruishuo--posterly/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Install with an agent.** Paste to your coding agent:

> Install this skill for me: https://github.com/Chenruishuo/posterly

It clones the repo, installs the Python dependencies, and runs the smoke test. The manual steps:

`/absolute/path/to/dedicated-env/bin/python` below is a placeholder: replace it with the verified absolute interpreter path of your dedicated non-base environment before running any command. Always use that interpreter for tools, `-m pip`, and `-m playwright`; never use base or rely on shell activation.

# 1. Clone where your agent discovers skills — e.g. ~/.claude/skills/ for Claude Code
#    (other agents: use their skills directory)
git clone https://github.com/Chenruishuo/posterly ~/.claude/skills/posterly
cd ~/.claude/skills/posterly

# 2. Python deps
/absolute/path/to/dedicated-env/bin/python -m pip install "playwright>=1.40"
/absolute/path/to/dedicated-env/bin/python -m playwright install chromium
# On a fresh Linux box you may also need the system libs Chromium links against:
#   /absolute/path/to/dedicated-env/bin/python -m playwright install --with-deps chromium
#   # or sudo apt install libnss3 libatk1.0-0 libatk-bridge2.0-0 libcups2 \
#   #                     libdrm2 libxkbcommon0 libxcomposite1 libxdamage1 \
#   #                     libxrandr2 libgbm1 libpango-1.0-0 libcairo2 libasound2

# 3. System dep for verify-final's pdfinfo
#    Linux:   apt install poppler-utils
#    macOS:   brew install poppler
#    Windows: choco install poppler

# 4. Smoke test
cd examples/hello_world
/absolute/path/to/dedicated-env/bin/python ../../tools/poster_check.py preflight  poster.html
/absolute/path/to/dedicated-env/bin/python ../../tools/poster_check.py measure    poster.html
/absolute/path/to/dedicated-env/bin/python ../../tools/poster_check.py polish     poster.html
/absolute/path/to/dedicated-env/bin/python ../../tools/render_preview.py          poster.html
/absolute/path/to/dedicated-env/bin/python ../../tools/poster_check.py verify-final poster_preview.pdf --from-html poster.html

# 5. (dev) run the test suite
/absolute/path/to/dedicated-env/bin/python -m pip install "pytest>=7" && /absolute/path/to/dedicated-env/bin/python -m pytest

The `poster_check.py` calls should print `PASS`, and `render_preview.py` should write `poster_preview.pdf` + `poster_preview.png`. posterly is clone-only (no PyPI); `pyproject.toml` holds the dependencies and pytest config.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 174 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: posterly
  3. disable-model-invocation: true
  4. description: "Create or revise academic conference posters in HTML/CSS and export print-ready PDFs. Use for poster design, layout edits, and print export."
  5. allowed-tools: Bash(*), Read, Write, Edit, Grep, Glob, Agent, AskUserQuestion, WebFetch, WebSearch
  6. ---
  7. # posterly — HTML/CSS Academic Poster Workflow
  8. A poster is **one HTML file** styled for an exact print canvas, rendered to PDF via Playwright + Chromium. Iterate by **measuring**, not eyeballing — the screen preview lies; only `emulate_media("print")` at the correct viewport tells the truth.
  9. ## Mental model
  10. ```
  11. HTML (with @page { size: W H })
  12. │
  13. ▼ print-emulate Chromium at W×96 × H×96 px viewport
  14. │
  15. ▼ data-measure-role tags identify columns/hero/footer-strip
  16. │
  17. ├──→ tools/poster_check.py measure (HARD GATE — spread < 5 px,
  18. │ gap-to-strip ∈ [30,50] px,
  19. │ intercard gap ∈ [12,50] px,
  20. │ poster bbox aligns to page
  21. │ within ±2 px)
  22. ├──→ tools/poster_check.py preflight (LaTeX residue, math `<`, missing imgs)
  23. ├──→ tools/render_preview.py (PDF + thumbnail)
  24. └──→ tools/poster_check.py verify-final (PDF page count / dims / size)
  25. ```
  26. The skill is venue- and lab-neutral by default. Compose a design direction from `templates/DESIGN-AXES.md` (Step 2.5), scaffold from the nearest template in `templates/README.md`, edit `:root` design tokens to match the locked direction, fill TODO placeholders with your paper's content.
  27. ## Canvas constants
  28. | Constant | Value | Notes |
  29. |---|---|---|
  30. | `--u` (CSS unit) | print = `1mm`, screen = `1.6px` | Use `calc(N * var(--u))` for ALL sizing. |
  31. | Print viewport (px) | `W_in × 96` × `H_in × 96` | Computed by `poster_check`/`render_preview`. |
  32. | Body cols | 2 / 3 / 4, or 1 hero + 1 column | Per template. |
  33. | Strict alignment | **spread < 5 px** (aim < 3) | Hard, non-negotiable gate. |
  34. <a id="python-environment"></a>
  35. ## Python environment
  36. **Invoke Python by the full path of a dedicated, non-base environment.** `/absolute/path/to/dedicated-env/bin/python` is a placeholder: replace it with the verified absolute interpreter path of the current machine's dedicated non-base environment for Posterly tools and Python snippets. Install missing Python dependencies with `/absolute/path/to/dedicated-env/bin/python -m pip install ...`, and run Playwright installation with the same interpreter's `-m playwright`. Never use bare `python`, `python3`, or `pip`, rely on `conda activate`, or install into base. A missing module must be resolved in the dedicated environment, not by falling back to base.
  37. Tool help, diagnostics, and exported examples may use portable shorthand; before executing those commands, expand it to that full path. `run_gates.py` already launches its Python children through `sys.executable`, preserving the selected interpreter. Keep all existing command arguments, installation approval boundaries, and validation obligations.
  38. ## Reading contract and execution boundaries
  39. **Before performing each stage, you must read and execute its linked applicable sections**, including substeps, exceptions, examples, manual checks, and prerequisites. Read the required sections, not every referenced file in full. Mandatory instructions and checks remain mandatory; optional helpers remain optional. The routes below do not replace those instructions.
  40. **Paths:** Markdown links are relative to the containing file. Command and inline paths such as `tools/`, `templates/`, `assets/`, `specimens/`, `README`, and `<skill>` are relative to the skill root (the directory containing `SKILL.md`); poster working paths retain their working-directory meaning.
  41. <a id="task-modes"></a>
  42. **Choose the task path before starting.**
  43. - **New poster or overall redesign:** follow the complete design workflow below, including Step 2.5's 2–3 rendered candidates and design lock. Reuse supplied answers under the confirmation policy.
  44. - **Local edit to an existing poster:** when the requested text, number, or asset changes preserve the canvas size/orientation and the accepted design direction, edit the existing working HTML directly. Reuse its current design, tokens, and recorded decisions; **do not recompose or render 2–3 design candidates, ask for another design selection, or copy a fresh gallery scaffold over the poster**. Read the relevant Step 3 authoring/component contracts and writing guidance for the edit, and Step 2 requirements for affected assets. Routine reflow/spacing repairs within the same direction remain local edits and still follow the existing style/fix rules.
  45. Both paths retain source/venue verification, Step 3 authoring/copy/theorem obligations, the mandatory Step 3.5 content audit on the filled or updated poster, Step 4–6 checks and visual inspection, and Step 7 final-file verification/export. Existing unchanged-version preflight/polish reuse remains available; changing text, numbers, assets, or layout invalidates the corresponding old results. Step 6.5 cross-model final review remains strongly recommended. The local-edit path changes design preparation, not those quality requirements.
  46. If the requested work requires a different canvas or design direction, follow the existing confirmation policy before applying the change and use the complete design workflow. Follow the confirmation, non-interactive, identity, system-extension, and upstream-feedback rules in the linked stages.
  47. <a id="confirmation-policy"></a>
  48. **Reuse supplied answers and existing confirmations.** For the same poster and unchanged decision, directly use information the user has already supplied or confirmed in the conversation or project notes: dimensions/orientation, palette, logos, QR target, density/block count, source paths, and content preferences. Explicit “none”, “no preference”, and “you choose” are answers within their stated scope, not missing information. Ask only about missing items or unresolved conflicts; do not repeat a question merely because another workflow stage mentions it. Record answers and keep required source/venue checks: reusing an answer does not waive verification. Do not transfer a choice from a different poster without evidence that it applies here.
  49. **Changes to locked choices still need confirmation.** Before applying a proposed change to the locked canvas size/orientation or design direction, obtain confirmation for that change; an explicit user instruction authorizing that exact change already supplies it and must not be asked again. The existing non-interactive design-direction exception remains as documented. Reusing one preference does not authorize a different system extension, crop/waiver decision, or external action; retain those original approval boundaries and any approval already granted for the same action.
  50. Read the universal [pitfalls](references/pitfalls.md#universal-pitfalls) before authoring; read layout-specific pitfalls and all applicable [visual rules](references/visual-polish.md) before authoring/inspecting affected content. These contain preventive and manual obligations even when automated checks pass. During a fix, consult the relevant rule rather than reloading unrelated cases.
  51. **Style rules 4 and 5 are opt-in requirements.** Enforce the two-hue-family limit (rule 4) and gradient restrictions (rule 5) only when the respective rule is explicitly enabled for the current poster. Otherwise **ignore the corresponding requirements**, including rules repeated as component anti-patterns or recommended catalog conventions; do not reduce palette breadth or remove gradients to satisfy a disabled rule. Other requirements remain in force. Keep tool flags consistent with that choice; see the [style-rule switch contract](references/validation.md#style-gate).
  52. ### Step 0 / Step 0.5 / Step 1 — Venue, discovery, and source content
  53. At each stage, read and follow [venue](references/design-workflow.md#venue), [discovery](references/design-workflow.md#discovery), and [content](references/design-workflow.md#content). Apply the [confirmation policy](#confirmation-policy) to missing or conflicting inputs; verify sources even when answers are already supplied.
  54. For palette work, read [palette derivation](templates/THEMES.md#palette-derivation), including seed-independent rules when the user supplies colors and the theme mechanisms in that file.
  55. ### Step 2 — Image preprocessing
  56. Read and follow [image preprocessing](references/assets.md#image-preprocessing) for the figures, QR codes, and logos used. Read [Gate A](references/visual-polish.md#gate-a) before figure placement and [Gate E](references/visual-polish.md#gate-e) before logo placement.
  57. Read and execute the [real-figure provenance contract](references/assets.md#figure-provenance) only when adopting it. Otherwise asset verification is `NOT_RUN`, not verified; ordinary image-processing and fidelity requirements still apply.
  58. ### Step 2.5 — Compose, show, and lock the design (new posters / redesigns)
  59. For new posters or redesigns, read and follow [design direction](references/design-workflow.md#direction) and [DESIGN-AXES](templates/DESIGN-AXES.md): compose and render 2–3 candidates, then lock the selection. Apply the documented batch and non-interactive rules. [Local edits](#task-modes) keep the accepted direction.
  60. Before preparing fonts or tokens, read direction item 4. Always write `design_tokens.json` at design lock and pass it on every gate run.
  61. ### Step 3 — Scaffold, content, and identity
  62. For new scaffolds, read and follow [scaffolding](references/design-workflow.md#scaffold), [template contracts](references/design-workflow.md#templates), and [gallery](templates/README.md). Local edits apply the [Step 3 authoring contracts](references/design-workflow.md#scaffold) to the existing HTML without copying a fresh scaffold. Both paths must follow [identity](references/design-workflow.md#identity) and the [COMPONENTS](templates/COMPONENTS.md) entries for every component used.
  63. Before scaffolding, read the [style gate](references/validation.md#style-gate); run it right after the scaffold and on every layout change within its documented scope.
  64. Read and follow [WRITING](templates/WRITING.md), perform its pre-loop sweep and Step 3's theorem/equation check. Do not try to make an unfilled scaffold pass filled-poster gates.
  65. ### Step 3.5 — Content audit
  66. After filling or updating the poster, and before Step 4, read and execute the mandatory [content audit](references/review.md#content-audit) and applicable [review checkpoints](references/review.md#review-checkpoints). Proceed only after every finding is fixed or explicitly recorded as a user-acknowledged tradeoff.
  67. ### Step 4 — Budgeted layout loop
  68. Before the first loop, read and follow [measurement](references/validation.md#measure-loop), [enhanced gates](references/validation.md#enhanced-gates), [runner](references/validation.md#gate-runner), [style gate](references/validation.md#style-gate), and [fix discipline](references/validation.md#fix-discipline).
  69. Use the complete `run_gates.py` sequence after each layout change under the documented template/fallback scope. Apply [unchanged-version result reuse](references/validation.md#result-reuse) only when its conditions hold. Follow the hard thresholds and exit-3 circuit breaker; do not reset the budget just to continue grinding or bypass system-extension approval. Consult [tool contracts](references/validation.md#tools) for the commands used.
  70. ### Step 5 / Step 6 — Render, inspect, and polish
  71. Read and execute [visual inspection](references/validation.md#visual-inspection), [polish](references/validation.md#polish-workflow), and every applicable [Gate A–G](references/visual-polish.md). Full standalone-polish coverage is required, with reuse only under the [unchanged-version rule](references/validation.md#result-reuse). Fix or explicitly accept each soft warning; hard gates remain mandatory. A green measurement does not replace visual inspection. While inspecting, also confirm every display equation is centred in its `.eqn` strip; a formula hugging the left edge with blank space to its right is a defect — diagnose the cause yourself, never ship it.
  72. ### Step 6.5 — Final review (cross-model strongly recommended)
  73. Final review is **strongly recommended**, preferably with a fresh reviewer from a different model family; it is not a delivery prerequisite. When performing it, read and execute [final review](references/review.md#final-review), [cross-model review](references/review.md#cross-model-review), and applicable [checkpoints](references/review.md#review-checkpoints), including evidence, finding resolution, and revalidation after fixes. Use the documented alternatives when cross-model review is unavailable.
  74. ### Step 7 — Verification and handover
  75. Read and execute [final verification, exports, bundling, and reporting](references/validation.md#final-verification), including its upstream-feedback consent boundary.
  76. Completion requires the Step 3.5 audit, all applicable hard gates, manual inspections, warning disposition, and Step 7 verification and deliverables. If final review is performed, resolve its findings and revalidate resulting fixes as required.
  77. <a id="section-map"></a>
  78. ## Complete section map (including legacy Step / § references)
  79. Use this map for a global overview and legacy Step/Gate/section names; individual instructions link directly to their target sections. Sections were relocated from the original SKILL.md and include approved revisions. `preserved-source` comments identify historical source locations, not byte-for-byte equivalence. Style-rule 4/5 wording throughout follows the opt-in contract above. Any other unresolved pre-existing tensions remain **待确认** for a later content change; that label itself does not waive a rule.
  80. | Original section / lookup term | Current home |
  81. |---|---|
  82. | Step 0; Step 0.5; Step 1 | [Venue](references/design-workflow.md#venue), [discovery](references/design-workflow.md#discovery), [content](references/design-workflow.md#content) |
  83. | Palette derivation | [THEMES: original derivation](templates/THEMES.md#palette-derivation) |
  84. | Step 2; image preprocessing; crop hygiene | [Assets](references/assets.md#image-preprocessing) |
  85. | Step 2.5; DESIGN DIRECTION; fonts/tokens; anti-convergence | [Design direction](references/design-workflow.md#direction) |
  86. | Step 3; BASE DEFENSES; microcopy; emphasis; theorem/equation sanity | [Scaffold](references/design-workflow.md#scaffold) |
  87. | Step 3.5; evidence pack; reviewer prompt | [Content audit](references/review.md#content-audit) |
  88. | Identity mark; anonymous submission | [Identity](references/design-workflow.md#identity) |
  89. | Step 4; fine-tuning; budget; safety nets; preflight | [Measure loop](references/validation.md#measure-loop) |
  90. | Step 5; crop inspection; DPI; identity paint | [Visual inspection](references/validation.md#visual-inspection) |
  91. | Step 6; soft gate; text-wrap | [Polish workflow](references/validation.md#polish-workflow) |
  92. | Step 6.5 | [Final review](references/review.md#final-review) and [cross-model review recommendation](references/review.md#cross-model-review) |
  93. | Step 7; PNG; bundle; upstream feedback | [Final verification](references/validation.md#final-verification) |
  94. | Visual polish gates; Gate A; BANNER/IMAGE-SLOT | [Visual rules](references/visual-polish.md#visual-gates), [Gate A](references/visual-polish.md#gate-a), [banner scaffold rules](references/design-workflow.md#scaffold) |
  95. | Gate B; WIDOW; ORPHAN; GLUE-CHAIN; timing rule | [Typography](references/visual-polish.md#gate-b) |
  96. | Gate C; CARD/TRAILING; CARD/INNER-VOID; CARD/TRACK-MISALIGN; TRACK/INNER-VOID; Fill means substance | [Balance rules](references/visual-polish.md#gate-c) |
  97. | Gate D; LAYOUT/FLEX-BR | [Flex breaks](references/visual-polish.md#gate-d) |
  98. | Gate E; Header logos; title squeeze; rails | [Header rules](references/visual-polish.md#gate-e) |
  99. | Gate G; CONTRAST; optional packing advisor | [Composed contrast and advisor note](references/visual-polish.md#gate-g) |
  100. | Universal / Layout-shared pitfalls | [Universal](references/pitfalls.md#universal-pitfalls), [layout-shared](references/pitfalls.md#layout-pitfalls) |
  101. | When to call an external LLM reviewer | [Three checkpoints](references/review.md#review-checkpoints) |
  102. | Tools; pack; fit-logos; bundled MathJax | [Tool contracts](references/validation.md#tools) |
  103. | Enhanced gates; One-shot gate runner; Style HARD gate | [Enhanced](references/validation.md#enhanced-gates), [runner](references/validation.md#gate-runner), [style](references/validation.md#style-gate) |
  104. | Real-figure provenance gate | [Asset contract](references/assets.md#figure-provenance) |
  105. | Fix discipline; escape hatch; round caps | [Fix discipline](references/validation.md#fix-discipline) |
  106. | Cross-model final review | [Cross-model review recommendation](references/review.md#cross-model-review) |
  107. | Templates; adding a template | [Template rules](references/design-workflow.md#templates) |
  108. <a id="key-rules"></a>
  109. <!-- preserved-source: SKILL.md lines 747-754 -->
  110. ## Key rules
  111. - **Never invent paper numbers.** Read the `.tex` source. Bench numbers, datasets, model names — all verifiable.
  112. - **Context discipline in the measure loop.** Never emit the whole poster.html through your output (scaffold via `cp`, edit surgically); don't re-`Read` the full file each iteration — work from `measure`'s edit-targets block (source line + anchor, then read just the surrounding block to confirm before editing). Full re-reads are for: an unfamiliar template, a cross-column re-pack, structural failures, a missing/ambiguous anchor, and the final audit.
  113. - **Respect the circuit breaker.** `measure` exit 3 means the loop is not converging — re-pack / rescope / escalate; don't `--reset-budget` to keep grinding.
  114. - **Card-shadow visibility is non-negotiable.** A poster looks cheap when shadows are clipped.
  115. - **Strict alignment is non-negotiable.** Spread < 5 px or it's not done — do not report success until `measure` exits 0.
  116. - **Preserve user-judgment decisions across sessions.** "Do not revert" notes (`✉ stays on Author X`, `α-sensitivity card removed`) — re-read the user's prior messages before "improving" a section.
  117. <!-- end-preserved-source: 747-754 -->
README.md · README · 224 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <h1 align="center">
  2. <picture>
  3. <source media="(prefers-color-scheme: dark)" srcset="docs/posterly-logo-dark.png">
  4. <img src="docs/posterly-logo-light.png" alt="posterly" width="460">
  5. </picture>
  6. </h1>
  7. <p align="center"><b>Build academic conference posters as a single HTML/CSS file,<br>rendered to print-ready PDF via headless Chromium.</b></p>
  8. <p align="center">
  9. <a href="LICENSE"><img src="https://img.shields.io/badge/License-AGPL_v3-blue.svg" alt="License: AGPL v3"></a>
  10. <img src="https://img.shields.io/badge/python-3.10+-blue.svg" alt="Python: 3.10+">
  11. <img src="https://img.shields.io/badge/coding_agent-skill-7B2CBF.svg" alt="Agent skill">
  12. </p>
  13. <p align="center">
  14. <a href="https://tryposterly.com"><img src="https://img.shields.io/badge/Try_it-tryposterly.com-0e7490?style=for-the-badge&logo=googlechrome&logoColor=white" alt="Try posterly at tryposterly.com"></a>
  15. &nbsp;
  16. <a href="https://tryposterly.com/blog"><img src="https://img.shields.io/badge/Read_the_blog-how_posterly_works-b45309?style=for-the-badge&logo=readthedocs&logoColor=white" alt="Read the posterly blog"></a>
  17. </p>
  18. <p align="center">English · <a href="README.zh-CN.md">简体中文</a></p>
  19. p⊕sterly turns a paper into a print-ready conference poster at the exact canvas size you set — ICML, NeurIPS, ICLR, CVPR, or custom. Command-line checks catch overflow, misalignment, and off-palette styling before you print.
  20. **Two ways to use it:**
  21. - **Open-source skill (this repo).** Clone it and drive it from a coding agent — Claude Code, Codex, or any agent that supports skills. Runs on your machine; needs no posterly account.
  22. - **Hosted service.** [**tryposterly.com**](https://tryposterly.com) runs it for you, **now open to everyone**, pay-as-you-go, in two engine tiers: Claude + GPT (best practice) and GPT-only at a quarter of the price ([pricing](https://tryposterly.com/pricing)).
  23. If you don't run a coding agent, or wouldn't trust yours with this, and you want posterly at its best without the setup, use the hosted service. It costs money, and every order comes with a receipt.
  24. > [!IMPORTANT]
  25. > **Do not run posterly above `high` effort.** This applies to GPT-5.6 Sol and other GPT models, and to Claude Opus as well. At higher effort levels, these models tend to overthink, second-guess, or drift away from posterly's required workflow, which can lead to substantially worse poster results.
  26. >
  27. > **Use `high` as the maximum recommended effort level.**
  28. The [blog](https://tryposterly.com/blog) walks through how posterly turns a paper into a checked, print-ready poster.
  29. ---
  30. ## News
  31. - **2026-08-04** · 💸 **A GPT-only tier at a quarter of the price.** GPT-5.6-sol optimizes hard toward a stated goal, which made a recipe possible in which GPT alone runs the whole pipeline and converges in far fewer rounds. Same hard gates, 25% of the Claude + GPT price; the cost is a little design flair and a little care in the small details. See [pricing](https://tryposterly.com/pricing) and the [gallery](https://tryposterly.com/gallery).
  32. - **2026-08-04** · 💳 **WeChat Pay is enabled**, alongside cards at checkout.
  33. - **2026-07-25** · 🎉 **The hosted service is open to everyone** — no invite, no waitlist. Pay-as-you-go, itemized receipt per order; see [pricing](https://tryposterly.com/pricing).
  34. - **2026-07-19** · 🎨 **A *dramatically* wider design range** — posterly now composes many more distinct design directions per paper. See the [blog](https://tryposterly.com/blog) and [`templates/DESIGN-AXES.md`](templates/DESIGN-AXES.md).
  35. - **2026-07-18** · 🚀 **[tryposterly.com](https://tryposterly.com) is live** — website, [blog](https://tryposterly.com/blog), and the hosted cloud service. ~~Private beta; payments not yet enabled.~~
  36. - **2026-07-05 – 07-12** · ⭐ **~50 posters at ICML 2026** were made with posterly.
  37. ---
  38. ## Showcase
  39. **Nine examples, not nine templates.** posterly composes each direction from choices in layout, typography, palette, framing, density, and masthead — these nine are a sample of the combinations available. Below is one paper ([*PowerFlow*](https://arxiv.org/abs/2603.18363), ICML 2026) run through it nine times: the paper and content are held fixed, so only the design varies. Every one passes posterly's hard checks.
  40. <p align="center">
  41. <img src="docs/showcase/powerflow_directions.jpg" alt="Nine posters for one paper, each a different design" width="100%">
  42. </p>
  43. Open any as a print-ready PDF — left to right, top to bottom:
  44. <p align="center">
  45. <b>Landscape · 60×36</b> —
  46. <a href="docs/showcase/directions/evidence-board.pdf">Evidence board</a> ·
  47. <a href="docs/showcase/directions/musical-score.pdf">Musical score</a> ·
  48. <a href="docs/showcase/directions/theatre.pdf">Theatre</a> ·
  49. <a href="docs/showcase/directions/orrery.pdf">Orrery</a> ·
  50. <a href="docs/showcase/directions/certificate.pdf">Certificate</a> ·
  51. <a href="docs/showcase/directions/escort-broadside.pdf">Escort broadside</a><br>
  52. <b>Portrait · 24×36</b> —
  53. <a href="docs/showcase/directions/control-panel.pdf">Control panel</a> ·
  54. <a href="docs/showcase/directions/cartographic.pdf">Cartographic survey</a> ·
  55. <a href="docs/showcase/directions/heat-treatment.pdf">Heat treatment</a>
  56. </p>
  57. ---
  58. ## Why HTML + CSS, not LaTeX?
  59. - **Fast preview.** Edit CSS and refresh — no recompile step.
  60. - **Modern layout.** Flexbox, grid, gradients, `text-wrap: balance`, and web fonts are available directly, without stacking LaTeX poster packages.
  61. - **Checkable in code.** "Is this column overflowing?" becomes a Playwright geometry query instead of a visual guess.
  62. - **Exact print size.** `@page { size: 60in 36in }` with Chromium's `page.pdf()` produces a PDF whose dimensions match the canvas.
  63. Math is typeset with MathJax rather than natively by the browser: templates use the CDN when opened directly, and the gate/preview renders serve a bundled copy, so measurement works offline. [`SKILL.md`](SKILL.md) has the details.
  64. ---
  65. ## Install
  66. **Install with an agent.** Paste to your coding agent:
  67. > Install this skill for me: https://github.com/Chenruishuo/posterly
  68. It clones the repo, installs the Python dependencies, and runs the smoke test. The manual steps:
  69. `/absolute/path/to/dedicated-env/bin/python` below is a placeholder: replace it with the verified absolute interpreter path of your dedicated non-base environment before running any command. Always use that interpreter for tools, `-m pip`, and `-m playwright`; never use base or rely on shell activation.
  70. ```bash
  71. # 1. Clone where your agent discovers skills — e.g. ~/.claude/skills/ for Claude Code
  72. # (other agents: use their skills directory)
  73. git clone https://github.com/Chenruishuo/posterly ~/.claude/skills/posterly
  74. cd ~/.claude/skills/posterly
  75. # 2. Python deps
  76. /absolute/path/to/dedicated-env/bin/python -m pip install "playwright>=1.40"
  77. /absolute/path/to/dedicated-env/bin/python -m playwright install chromium
  78. # On a fresh Linux box you may also need the system libs Chromium links against:
  79. # /absolute/path/to/dedicated-env/bin/python -m playwright install --with-deps chromium
  80. # # or sudo apt install libnss3 libatk1.0-0 libatk-bridge2.0-0 libcups2 \
  81. # # libdrm2 libxkbcommon0 libxcomposite1 libxdamage1 \
  82. # # libxrandr2 libgbm1 libpango-1.0-0 libcairo2 libasound2
  83. # 3. System dep for verify-final's pdfinfo
  84. # Linux: apt install poppler-utils
  85. # macOS: brew install poppler
  86. # Windows: choco install poppler
  87. # 4. Smoke test
  88. cd examples/hello_world
  89. /absolute/path/to/dedicated-env/bin/python ../../tools/poster_check.py preflight poster.html
  90. /absolute/path/to/dedicated-env/bin/python ../../tools/poster_check.py measure poster.html
  91. /absolute/path/to/dedicated-env/bin/python ../../tools/poster_check.py polish poster.html
  92. /absolute/path/to/dedicated-env/bin/python ../../tools/render_preview.py poster.html
  93. /absolute/path/to/dedicated-env/bin/python ../../tools/poster_check.py verify-final poster_preview.pdf --from-html poster.html
  94. # 5. (dev) run the test suite
  95. /absolute/path/to/dedicated-env/bin/python -m pip install "pytest>=7" && /absolute/path/to/dedicated-env/bin/python -m pytest
  96. ```
  97. The `poster_check.py` calls should print `PASS`, and `render_preview.py` should write `poster_preview.pdf` + `poster_preview.png`. posterly is clone-only (no PyPI); `pyproject.toml` holds the dependencies and pytest config.
  98. ---
  99. ## Use the skill
  100. Point your agent at the paper's source directory:
  101. > Use the posterly skill to make my ICML 2026 poster from the LaTeX project at ~/papers/mypaper/. Logos are in ~/papers/mypaper/logos/, and the QR code should link to https://github.com/you/yourcode
  102. In Claude Code, `/posterly` is the shortcut for that.
  103. The LaTeX source is the only required input; the agent reads it directly and is instructed to ground every number and claim in the paper. Venue, logos, a QR target, brand colors, style preferences, and text density are optional — the agent asks for any it needs before drafting.
  104. You don't choose a look from a list. posterly renders two or three different design directions as thumbnails, you pick one by eye, and it then fills, checks, and exports that poster — each one carrying a light touch of posterly's own house style. Read the workflow overview on the [blog](https://tryposterly.com/blog); the full design reference is in [`templates/DESIGN-AXES.md`](templates/DESIGN-AXES.md).
  105. Direct PDF input (instead of LaTeX) is untested so far.
  106. ---
  107. ## What's in here
  108. ```
  109. posterly/
  110. ├── SKILL.md ← the workflow your agent follows for /posterly
  111. ├── tools/
  112. │ ├── run_gates.py ← runs the check gates into one report
  113. │ ├── poster_check.py ← preflight / measure / pack / fit-logos / polish / verify-final / bundle
  114. │ ├── render_preview.py ← print-emulated PDF + thumbnail PNG
  115. │ ├── style_check.py ← design-token gate
  116. │ ├── asset_check.py ← real-figure provenance (opt-in)
  117. │ ├── extract_pdf_figures.py, preprocess_figures.py
  118. │ └── _posterly/ ← internal modules
  119. ├── templates/ ← landscape_4col, landscape_hero, portrait_2col
  120. ├── specimens/axes/ ← rendered catalog of the design options
  121. ├── examples/hello_world/ ← minimal poster the install smoke test and tests run against
  122. ├── docs/showcase/ ← the showcase montage + a PDF per direction
  123. └── tests/ ← pytest suite
  124. ```
  125. The checks, briefly:
  126. - **`run_gates.py`** runs `preflight → style → asset → measure → polish` into one report (`asset` is reported `NOT_RUN` without a `--manifest`). It's the default loop while drafting.
  127. - **`poster_check.py`** exposes the checks individually — `preflight` (static lint), `measure` (print-emulated geometry), `pack` and `fit-logos` (advisory pre-checks), `polish` (soft visual checks), and `verify-final` (post-render PDF sanity, run separately on the exported PDF).
  128. Each command supports `--help`; [`SKILL.md`](SKILL.md) has the thresholds and tuning flags, and [`templates/README.md`](templates/README.md) the template conventions.
  129. ---
  130. ## Editing by hand
  131. For manual editing, copy the closest scaffold from [`templates/`](templates/) and change the shared values in its `:root` token block — the style gate expects colors and sizes to come from there, not from individual elements. A tokenized poster keeps its gate metadata in `design_tokens.json`.
  132. - Template contracts — [`templates/README.md`](templates/README.md)
  133. - Design options — [`templates/DESIGN-AXES.md`](templates/DESIGN-AXES.md)
  134. - Palette and token reference — [`templates/THEMES.md`](templates/THEMES.md)
  135. - Copy voice / de-AI style pass — [`templates/WRITING.md`](templates/WRITING.md)
  136. - Full agent workflow — [`SKILL.md`](SKILL.md)
  137. (`examples/hello_world` is a minimal install/test fixture, not a general starting point.)
  138. ---
  139. ## License
  140. posterly is licensed as a whole under the **GNU Affero General Public License
  141. v3.0** (AGPL-3.0) © 2026 Ruishuo Chen — see [LICENSE](LICENSE). You may use,
  142. modify, and commercialize it, **but any distributed or network-deployed (SaaS)
  143. derivative must release its complete corresponding source under the same
  144. license**. This is deliberate: it keeps posterly open and prevents closed-source
  145. commercial exploitation.
  146. This repository also vendors a few **MIT-licensed** gate tools from
  147. [ARIS](https://github.com/wanshuiyin/Auto-claude-code-research-in-sleep); those
  148. specific files remain available under their original MIT license. MIT is
  149. GPL/AGPL-compatible, so the project as a whole is AGPL-3.0 while the vendored
  150. files stay individually MIT. Details: [NOTICE.md](NOTICE.md) and
  151. [LICENSES/](LICENSES/).
  152. ---
  153. ## Star History
  154. <div align="center">
  155. <!-- star-history:start -->
  156. <picture>
  157. <source media="(prefers-color-scheme: dark)" srcset="docs/star-history/star-history-dark.svg">
  158. <img alt="Star history" src="docs/star-history/star-history-light.svg">
  159. </picture>
  160. <!-- star-history:end -->
  161. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.