Openpress deploy

Skill quan0715/open-press/skills/openpress-deploy

AI-first fixed-layout document workspaces. Your AI agent writes proposals, whitepapers, theses, books — A4, PDF, web reader.

Install

npx -y skills add quan0715/open-press --skill openpress-deploy

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

10 stars10 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use when preparing, configuring, checking, staging, or publishing an open-press document to public hosting, especially Cloudflare Pages, deploy setup, deploy buttons, deploy status, public release checks, or safe deployment workflow.

SKILL.md

2.9 KB, as published. Nobody here has run it

open-press Deploy

open-press deploy owns the public-release gate. Use it only when the user asks to configure, inspect, dry-run, or publish an open-press document.

Responsibilities

Inspect deploy config in openpress/settings.json under the "deploy" field.
Check target adapter, staging source, project name, and confirmation settings.
Run deploy preflight and dry runs.
Keep secrets out of source files.
Require explicit confirmation before publishing.
Report the public URL and, when included, the PDF URL after successful deploy.

Boundaries

openpress owns generic CLI usage, non-deploy validation, local review, and the source/generated boundary.
openpress-create-pages owns page artifact content and visual readiness.
openpress-create-slide owns slide deck content and visual readiness.
This skill owns public target confirmation and deploy execution.

Public Deploy Rule

Never publish without a clear confirmation that names the target project.

Good confirmation shape:

This will publish the current open-press build to Cloudflare Pages project `<projectName>` from `<deploy.source>`.
Do you want me to deploy now?

Preflight

Before real deploy, run the commands that prove the output is ready:

npm run build              # validates + renders dist-react/

Also scan public-facing source for unfinished markers:

rg "\\[TODO:|\\[FIX:|\\[DRAFT:" "press/*/chapters" press/design.md

PDF Size Limit

Cloudflare Pages rejects any single file larger than 25 MB. A multi-press or image-heavy PDF commonly exceeds this limit.

Unless the user explicitly asks to publish the PDF, deploy without it:

npm run openpress:deploy -- --confirm --no-pdf

--no-pdf skips PDF generation and excludes it from the deploy source entirely.

If the user wants to check the PDF size first:

npm run openpress:pdf
du -sh .deploy/**/*.pdf 2>/dev/null

If the PDF is over 25 MB and the user still wants it publicly hosted, recommend a separate host (Cloudflare R2, S3, etc.). OpenPress does not currently expose an authored external-PDF URL field, so do not invent one in openpress/settings.json; report the separate URL in the delivery handoff.

Deploy Commands

Dry run:

npm run openpress:deploy:dry-run -- --no-pdf

Publish after explicit confirmation:

npm run openpress:deploy -- --confirm --no-pdf

Remove --no-pdf only when the user explicitly includes the PDF in the confirmed publication target.

When To Read References

Read references/cloudflare-pages.md when creating or repairing Cloudflare Pages config, project setup, Wrangler auth expectations, or UI deploy-button behavior.