open-press

Open source · MIT · v0.3.0

Now Claude Code, Cursor & Codex can write serious documents.

Install the open-press skills into any project. Your AI agent learns how to write fixed-A4 proposals, whitepapers, theses — with PDF export, web reader, and deploy gates already wired up. 

$ npx skills add quan0715/open-press

Click to copy · skills install under .agents/skills/, auto-detected by Claude Code, Cursor, Codex, Gemini CLI, Cline, Continue, and 50+ other AI agents.

Try it · copy these into your AI agent

Talk to your agent like a writing partner.

After installing skills, open your folder in any AI tool and try one of these prompts.

Cold start — start a new project

Using openpress-init, help me set up a new workspace for a Series A investor proposal. Ask me about audience, language, and title, then run the init for me.

Turn existing material into a document

Take this PDF / these meeting notes / this repo README and turn them into chapter 1 of a whitepaper. Preserve confirmed facts. Mark missing numbers as [TODO].

Iterate on structure

Use openpress-document-hierarchy and openpress-writing. Re-bucket the current chapters into a public TOC and a deeper outline; H4 algorithms shouldn't show in the formal TOC.

Visual tweak

Use openpress-design. Switch the accent color to deep green, keep hairlines, and re-check PDF-safe contrast on the cover and TOC.

Ship it

Use openpress-deploy. Run a dry-run for Cloudflare Pages, then wait — don't publish until I confirm the project name.

What your agent gets

12 SKILL files. Every layer of writing a serious document.

openpress-writing

Audience, narrative, captions, factual boundaries. Loads portable writing skills (繁中, teaching notes) per content type.

openpress-design

Theme tokens, page surfaces, PDF-safe CSS. Tells the agent which CSS layer owns which decision.

openpress-document-hierarchy

H1/H2/H3/H4 model, TOC depth, appendix placement. Stops the agent from making every algorithm a chapter.

openpress-diagram-drawing

When a figure belongs vs a table vs prose. Diagram bodies stay semantic; explanation moves to captions.

openpress-deploy

Public-release gate. Forces confirmation naming the target Cloudflare Pages project before any deploy.

chinese-ai-writing-polish

Removes AI-like patterns from 繁體中文 professional writing. Auto-loaded when the document language is Chinese.

No project yet?

Scaffold a fresh workspace.

One command. Skills, framework, starter document, all wired up. 

$ npx @open-press/cli init my-doc --pack editorial-monograph

Available style packs: editorial-monograph (formal long-form) and claude-document (warm working notes).

How it works

SKILL files at the agent layer. Real code at the engine layer.

  1. 1.

    npx skills add quan0715/open-press installs the framework skill files into .agents/skills/ (and symlinks to .claude/skills/, etc., depending on the tools you have). 13 skills total — system, writing, design, deploy, plus portable Chinese / teaching skills.

  2. 2.

    Open the folder in your AI tool. Skills are auto-discovered — zero extra setup for Claude Code, Cursor, Codex, Gemini CLI, Cline, Continue, Warp, and 50+ others.

  3. 3.

    Tell the agent what you want. SKILL files supply routing, voice rules, structural conventions, design tokens, deploy gates. @open-press/core supplies the runtime React components and CLI; @open-press/cli scaffolds new workspaces.

  4. 4.

    Update later: npx skills upgrade for skills, npm update @open-press/core for the runtime. Both respect your hand-written customizations.