Teaching AI agents to stop producing ugly documents

What it does

Kami (Japanese for “paper”) is an agent skill — a bundle of layout rules, templates, and helper scripts — that Claude Code, Codex, Cursor, and other agents load so their document output actually looks designed. It ships eight document templates (one-pager, long doc, letter, portfolio, resume, slides, equity report, changelog) plus a landing-page system, and renders to PDF via WeasyPrint, to editable PPTX via python-pptx, or to Marp decks for Markdown-first workflows. It auto-triggers from plain requests like “make a one-pager for my startup” — no slash command.

The interesting bit

The boring part is the value: Kami encodes actual typographic taste — warm parchment background, ink-blue accents, one serif font per page, language-specific font fallbacks for CJK — as rules an agent can follow. It also verifies its own work: content schemas check structure before layout, coverage checks hunt for content that fell off the page, and page images support a final visual review. A zero-dependency MCP server lets any MCP-capable agent drive it as a rendering engine without loading the full skill prompt.

Key highlights

• Eight document templates plus a landing-page system, in English, Chinese, Japanese, and Korean (EN/CN most complete; JA/KO use font fallbacks and per-output checks)
• Eighteen inline SVG diagram types; Mermaid text gets rendered and re-themed to the Kami palette via a bundled script, no Node required
• Optional ~/.config/kami/brand.md profile persists your identity, brand color, and tone so you stop repeating preferences
• Opt-in white-paper variant flips documents to white for printing while keeping warm backgrounds in cards and tables
• Runs fully offline apart from a once-daily version check that resolves GitHub’s latest release and uploads nothing

Caveats

• Windows users must run it inside WSL (Ubuntu) — the helper scripts are Bash and WeasyPrint needs the GTK/Pango runtime natively
• Large CJK fonts are excluded from packages; a recovery script fetches them, falling back to a CDN
• Syntax highlighting needs Pygments installed; without it, code renders monochrome

Verdict

If you regularly ask an agent for resumes, reports, or slide decks and wince at the output, this is worth a look. If you already have a document pipeline you like, it’s a well-executed second opinion rather than a necessity.