Kami: A Quiet Design System for Professional Documents

Kami: A Quiet Design System for Professional Documents

Introduction: What Kami Means for Your Writing Kami (紙, かみ) translates to paper in Japanese—the surface where a finished idea lands. In an era where AI can draft documents with astonishing speed, the real bottleneck isn’t capability; it’s constraint. Without a design system, even strong outputs drift toward generic gray tones and inconsistent layouts session after session. Kami fills that gap: a single constraint language, nine versatile templates, and a workflow simple enough for agents to run reliably while strict enough to ensure every output is something you would actually ship.

Kami’s design philosophy begins with a deliberate, “quiet” aesthetic. It favors warmth, legibility, and editorial rhythm over flashy dashboards or flamboyant palettes. English and Chinese are first-class languages, with Japanese and Korean supported through best-effort CJK paths and a robust visual QA process before delivery. The system is part of a small trilogy: Kaku (書く) writes code, Waza (技) drills habits, and Kami (紙) delivers documents. The result is a cohesive ecosystem in which content moves from idea to polished document with a dependable, repeatable tempo.

Included imagery from the Input serves as an opening map of Kami’s world: from the clean, restrained logo to the crafted visuals of its demos and travel diagrams. This is a design system you can hand to an agent and trust to produce consistent, ships-ready documents.

See it: Examples in Practice Kami ships with a curated set of demonstrations that showcase its core strength: applying one constraint language across multiple deliverables. Here are the featured items you can explore (each item links to a live demo in PDF or HTML):

• Equity Report: Tesla Q1 2026 Chinese-language commentary on the company’s equity report. The demonstration image shows a professionally laid-out, data-rich one-page concept that blends markets and narrative in a single, readable canvas.
• Equ i ty Report · 中文Tesla Q1 2026 财报点评
• Slides: An English keynote of agent-level slides. This demo highlights Kami’s ability to render a concise, slide-ready deck that keeps typography, color, and layout coherent across pages.
• Slides · EnglishAgent keynote, 6 slides
• Resume (Korean): A Korean developer resume that demonstrates Kami’s support for multilingual resume styles with a clean, compact design.
• Resume · 한국어개발자 이력서, 2페이지
• Portfolio (Kaku): A Japanese-language portfolio from Kaku’s terminal works, a compact, 7-page showcase that emphasizes typographic hierarchy and clean composition.
• Portfolio · 日本語Kaku ターミナル作品集 · 7 ページ

Landing Pages: The Three Products, One Constraint Set Kami’s landing-page template demonstrates a core principle: one constraint set can power multiple products with distinct personalities. The template ships with companion artifacts to help you deploy multilingual sites quickly (vercel, sitemap, robots, llms, llms-full).

• Kami: English Design system homepage
• 
• Luo: Chinese CJK-reading font specimen
• 
• Mole: English macOS system utility
• 

Usage: Integrating Kami into Your Workflow Kami is designed to be plug-in friendly and adaptable to multiple agent ecosystems. The input provides practical paths for working with Claude Code, general agents, and Claude Desktop, with an emphasis on reliability, multilingual support, and an approachable setup.

• Claude Code: Use the Claude Code plugin marketplace to install Kami as a skill
• Command (Claude Code): npx skills add tw93/kami -a claude-code -g -y
• This integrates Kami’s constraint logic into Claude Code workflows so outputs stay within the defined design system.
• Claude Code Plugin Marketplace: Alternate path for installation
• Command: /plugin marketplace add tw93/kami /plugin install kami@kami
• Generic Agents: Works with Codex, OpenCode, Pi, and other readers
• Command: npx skills add tw93/kami -a '*' -g -y
• Claude Desktop: A desktop workflow that emphasizes “touchless” rendering
• Steps:
  • Download kami.zip
  • Open Customize > Skills > "+" > Create skill, upload the ZIP
  • The ZIP remains lightweight; Chinese fonts load from local checkout first, then the jsDelivr CDN
  • If rendering is off, Claude will fetch the fonts on the next run
• Updating: Download the same URL, click “…”, and choose Replace to refresh the skill
• Language Coverage: Optimized for English and Chinese; Japanese and Korean supported via best-effort CJK paths with visual QA before delivery
• Example prompts by language:
• English: “make a one-pager for my startup” • “turn this research into a long doc” • “write a formal letter” • “make a portfolio of my projects” • “build me a resume” • “design a slide deck for my talk” • “make this talk as a Marp deck” • “build a landing page for my app”
• 中文: “帮我做一份一页纸” • “帮我排版一份长文档” • “帮我写一封正式信件” • “帮我做一份作品集” • “帮我做一份简历” • “帮我做一套演讲幻灯片” • “帮我做一份 Markdown 风格的演示稿” • “帮我做一个产品落地页”
• 日本語: “スタートアップ向けの一枚資料を作って” • “この調査を長文レポートに整えて” • “正式な依頼文を作って” • “プロジェクト作品集を作って” • “履歴書を作って” • “登壇用スライドを作って” • “Marp で登壇スライドを作って” • “アプリのランディングページを作って”
• 한국어: “스타트업 원페이저를 만들어줘” • “이 리서치를 장문 문서로 정리해줘” • “정식 레터를 작성해줘” • “프로젝트 포트폴리오를 만들어줘” • “이력서를 만들어줘” • “발표용 슬라이드를 만들어줘” • “Marp 슬라이드로 만들어줘” • “앱 랜딩 페이지를 만들어줘”
• Optional brand profile: Create ~/.config/kami/brand.md to persist identity, defaults, and writing habits. A full template is described in brand.example.md, including YAML frontmatter (name, role, email, website, GitHub, brand color, language, page size, currency locale, tone) plus a Markdown body for freeform notes. Kami uses this as the lowest-resolution context, applying it only when a request is ambiguous and always overridable by the document’s needs. The goal is to feel familiar across work without making every output look the same.

Design: The Quiet Constraint System Kami’s aesthetic rests on a compact, dependable design system. It is not a UI framework but a constraint system for printed matter. The aim is to craft pages that feel composed rather than dashboards. The system defines nine template types that cover a broad spectrum of professional needs:

• One-Pager
• Long Doc
• Letter
• Portfolio
• Resume
• Slides
• Equity Report
• Changelog
• Landing Page

Each template is accessible in EN, CN, and KO, ensuring broad linguistic coverage for global teams.

A core suite of fourteen inline SVG diagram types is included, enabling crisp, scalable visuals that stay aligned with the editorial rhythm. The slides ship through three rendering paths: WeasyPrint HTML to PDF (the default), python-pptx for editable PPTX, and a Marp variant in assets/templates/marp/ for Markdown-first decks. Code blocks benefit from Pygments-based syntax highlighting when Pygments is installed; when not, PDFs still render with monochrome code. Kami’s renderer automatically selects the appropriate variant based on the language you write in.

Key design rules:

• Canvas: #f5f4ed parchment color across the page, never pure white
• Accent: Ink blue #1B365D only; no secondary chromatic hue
• Neutrals: Warm-toned, yellow-brown undertones; no cool blues/greys
• Serif: Body 400, headings 500; avoid heavy synthetic bold
• Line-height: Tight titles 1.1–1.3, dense body 1.4–1.45, reading body 1.5–1.55
• Shadows: Subtle ring or whisper shadows only
• Tags: Solid hex backgrounds; avoid rgba because of rendering quirks
• Fonts: A single serif font per language:
• Chinese: TsangerJinKai02
• Japanese: YuMincho
• Korean: Source Han Serif K
• English: Charter
• Licensing: TsangerJinKai is free for personal use; commercial use requires a license. Source Han Serif K is OFL-licensed. All other fonts are system-bundled.
• Travel/Illustrations: The same constraint system doubles as briefs for drawing tools; outputs inherit the warm parchment feel, ink-blue restraint, single-line geometric icons, and editorial typography.

Supporting Visuals: Travel and Architecture of Kami Kami’s travel section shows how the constraint system translates into visual briefs across diagrams and illustrations. The images below illustrate how a consistent design language adapts to different domains—from hardware patent diagrams to architecture redraws and data visualization tradeoffs:

• Evidence layout: Chinese Tesla Optimus hand-to-forearm patent overview
• 
• Architecture redraw: SpatialVLA figure 1 schematic (English)
• 
• Concept tradeoff: 3D representations of compute and inference tradeoffs (Chinese)
• 

Background: The Journey from Frustration to a System The origin story of Kami is as practical as its output. The author of Kami noticed a familiar problem: while AI can produce content, the outputs often arrive as visually inconsistent blocks in a gray, unreadable carousel of pages. The goal was to salvage readability and deliverability by introducing a robust, reusable design language that could be applied across different document types and languages.

The anecdote centers on a personal workflow: creating research reports in the United States, where the default doc look was drab and hard to scan. By iterating on typography, palette, spacing, and rhythm—one rule at a time—the output evolved into a page the author was excited to share. The same process was then abstracted and generalized into Kami, turning a one-off style experiment into a reliable design system. The result is a quiet, credible, ship-ready document framework that can be handed off to any agent to generate consistent, professional work.

Support, Community, and Licensing If Kami has helped you, the project invites you to share it with peers or give it a star on its repository. The community can contribute ideas or report bugs via Issues or PRs. The author even shares a personal touch—two cats named TangYuan and Coke—together with a tongue-in-cheek nod to cat food as a playful nod to the project’s light personality. The project uses an MIT license for the code and templates, inviting reuse and contribution. Font licensing remains careful: TsangerJinKai02 is free for personal use, with commercial licensing from tsanger.cn; Charter, YuMincho, and Source Han Serif K are open or system-licensed.

• See it, share it: If Kami helped you, share a link to the project and consider a star on the repository
• Get involved: Open issues or pull requests for improvements or bug fixes
• Fun aside: The author’s cats and a lighthearted sponsor note
• License: MIT for code and templates; font licenses explained in the fonts section

Brand and Identity: A Persistent Profile Kami’s design system supports the idea of a persistent brand identity. A brand profile file at ~/.config/kami/brand.md can persist identity, brand color, language, page size, currency locale, tone, and writing habits. The brand file acts as a quiet, low-res context that can be overridden by the specific document’s needs, ensuring a familiar feel across pages without forcing sameness. A template exists (brand.example.md) to guide the creation of this file, including both YAML frontmatter and a Markdown body for freeform notes.

Rendering and Output Paths: Where the Magic Emerges Kami’s output is designed to be practical in real-world environments. It emphasizes clean, printable documents on demand, with multiple rendering options to fit different workflows:

• WeasyPrint HTML to PDF: The default rendering path for high-fidelity PDFs
• python-pptx: An editable PPTX path for slide decks
• Marp: Markdown-first deck rendering via a dedicated variant in assets/templates/marp/
• Code blocks: Pygments-based syntax highlighting when installed; otherwise code remains readable in PDFs with monochrome styling

A subtle but powerful point: Kami picks the right variant automatically based on the language you’re using, helping ensure consistent output without extra fiddling during the writing process.

Practical Considerations: Typography, Spacing, and Editorial Rhythm The design system emphasizes editorial rhythm—clear hierarchy with restrained typography. The serif type for each language ensures readability and a timeless feel across pages. The subtle warm palette and parchment canvas provide a tactile sense of printed materials, which helps audiences engage with long-form content and formal documents alike.

In practice, you’ll encounter:

• Nine template types ready to cover common professional needs
• A stable, readable baseline across languages
• Inline SVG diagrams that scale without losing legibility
• A well-defined color system that avoids distracting hues
• Lightweight fonts and local fallback options to speed up rendering
• A robust process for integrating brand identity when needed

Background Images and Visuals in Practice In addition to the textual descriptions, Kami’s visuals help anchor the design in tangible assets. The included imagery demonstrates how the system handles different content types while maintaining a consistent look-and-feel. The image blocks in the See it section and the Travel diagrams provide an immediate sense of how the design constraints translate into across-page consistency, clean lines, and editorial balance.

Support, Community, and Licensing (Revisited)

• If Kami improved your workflow, consider sharing with others or giving it a star
• Open issues or PRs welcome to improve reliability and expand templates
• The licenses are friendly: MIT for code and templates; fonts with specific usage terms
• The design philosophy favors collaboration and continuous improvement, reflecting a community-driven ethos

Final Thoughts: The Quiet Power of Kami Kami isn’t about a flashy new UI or a dazzling color scheme. It is a quiet, reliable design system—one constraint language, nine templates, and a careful approach to typography, layout, and production paths. It aims to deliver documents that are not merely readable but ship-ready: coherent, legible, and aesthetically restrained, with a warmth that makes pages inviting rather than austere. By combining multilingual support, a robust rendering workflow, and a pragmatic approach to brand identity, Kami becomes a practical, scalable solution for teams producing professional documents at scale.

If you’re building reports, decks, resumes, portfolios, or landing pages for multilingual audiences, Kami offers a tested, repeatable framework to bring your content to life without sacrificing control. The system’s emphasis on constraint, consistency, and editorial rhythm makes it possible to translate ideas into well-crafted pages that readers will actually read—and want to share.

Images from the Input are integrated here to illustrate Kami’s philosophy and practice:

• Top logo:
• See it gallery:
• 
• 
• 
• 
• Landing pages:
• 
• 
• 
• Travel and diagrams:
• 
• 
• 

Conclusion: A System You Can Rely On Kami is a practical, design-forward framework for professional documents. It recognizes that the power of AI lies not only in speed but in disciplined constraints that preserve readability and ship-worthiness. By offering a coherent palette, typographic strategy, a spectrum of templates, and flexible rendering options, Kami provides a reliable backbone for producing high-quality content consistently. Whether you’re drafting equity reports, crafting slides, or building multilingual landing pages, Kami helps you keep your ideas intact as they move from concept to concrete page.