pdf-forge

pdf-forge

Professional PDF generation for AI coding agents. Slides and documents with Vercel/Stripe-quality aesthetics using pure HTML + Tailwind CSS. Works with Warp, Claude Code, Cursor, Codex, Augment Code, Gemini, and more.

The Problem

AI-generated PDFs look recognizably generic: inconsistent spacing, flat typography, random colors, endless bullet lists. pdf-forge solves this by encoding a complete design system — typography scales, spacing grids, color palettes, and layout patterns — into a Claude Code skill.

What It Does

• Generates slide presentations (16:9, 1920x1080), A4 documents, and Instagram social (post / carousel / story) from any content
• Uses static HTML + Tailwind CSS via CDN — no React, no build step, no component libraries
• Renders to PDF via Playwright (screenshots for slides, native PDF for documents), with optional PPTX export via python-pptx
• Includes 16 ready-to-use templates (8 slides + 7 documents + 1 social cover; more social archetypes planned)
• Applies a professional design system: zinc backbone, typographic contrast, restrained accents, overflow guard for fixed-viewport formats
• Supports brand customization (colors, fonts, theme) via per-project .claude/pdf-forge.local.md and bundled brand presets in assets/themes/

Installation

Cross-platform (recommended)

Installs the skill for all detected agents — Warp, Claude Code, Cursor, Codex, Augment Code, Gemini, and more:

git clone https://github.com/syx-labs/pdf-forge.git
cd pdf-forge
bun install
./install.sh            # creates symlinks + sets PDF_FORGE_HOME

Reload your shell (source ~/.zshrc) or open a new terminal. The skill is now available as /pdf-forge in every supported agent.

# Preview what will be created (no changes)
./install.sh --dry-run

# Remove all symlinks and env var
./install.sh --uninstall

How it works: The installer creates a canonical symlink at ~/.agents/skills/pdf-forge pointing to the project's skill directory, then creates relative symlinks from each platform (~/.claude/skills/, ~/.cursor/skills/, etc.) to the canonical location. It also exports PDF_FORGE_HOME in your shell profile so scripts can locate the project root.

Supported platforms:

• Warp (~/.agents/skills/, ~/.warp/skills/)
• Claude Code (~/.claude/skills/)
• Cursor (~/.cursor/skills/)
• Codex (~/.codex/skills/)
• Augment Code (~/.augment/skills/)
• Gemini CLI (~/.gemini/skills/)
• GitHub Copilot (~/.copilot/skills/)
• Factory (~/.factory/skills/)
• OpenCode (~/.opencode/skills/)

Platforms not installed on your machine are automatically skipped.

Claude Code (plugin)

Alternatively, install as a Claude Code plugin:

/plugin marketplace add syx-labs/pdf-forge
/plugin install pdf-forge@syx-labs-plugins

Claude Desktop (MCP server)

One command sets up everything — installs Playwright/Chromium and configures Claude Desktop:

npx pdf-forge-mcp setup

Then restart Claude Desktop. The pdf-forge tool and design system resources will be available.

Development

git clone https://github.com/syx-labs/pdf-forge.git
cd pdf-forge
bun install
bun run scripts/setup.ts

Usage

Ask Claude to create any PDF:

• "Create a pitch deck about our product"
• "Generate a financial report for Q4"
• "Make a professional proposal for the client"
• "Design slides for the investor meeting"

The skill automatically:

1. Detects the format (slides vs documents)
2. Selects appropriate layouts from the template catalog
3. Generates self-contained HTML pages with Tailwind CSS
4. Renders to PDF via Playwright

Brand Customization

Create .claude/pdf-forge.local.md in your project:

---
brand:
  name: "Your Company"
  primary: "purple-500"
  secondary: "orange-500"
  theme: "dark"
font:
  url: "https://fonts.googleapis.com/css2?family=Inter:[email protected]"
  family: "Inter"
# Optional: Instagram composition hints (read by Claude, not by the pipeline)
social:
  preset: "dark-editorial"      # which assets/themes/<name>.yaml Claude mirrors
  accent_gradient: "from-emerald-400 to-cyan-400"  # override preset gradient
  allow_photos: false           # gate photo-overlay archetype
  brand_handle: "@yourhandle"
  default_footer: true
---

Without this file, defaults apply: dark theme, Inter font, purple/orange accents.

The social: block is a composition contract for Claude, not a runtime config the pipeline parses. Claude reads it when generating HTML for the social format — picking the preset's palette and fonts, honoring overrides, and respecting the allow_photos gate. The renderer itself only reads data-social-format from the <body> tag to pick a viewport. See assets/themes/README.md for the preset list and skills/pdf-forge/SKILL.md "Workflow — Social" for how Claude consumes each field.

Templates

Slides (16:9)