Kami README

The project's README from github.com/tw93/Kami. As one markdown file: README.md.

Kami

Good content deserves good paper.

Stars Version License Twitter

Why

Kami gives AI agents templates and layout rules for documents and landing pages. Create PDFs and PNGs, or export slides as editable PowerPoint files.

Kami (紙, かみ) means paper in Japanese. It includes eight document templates, a landing-page system, and checks for content and layout.

Part of a trilogy: Kaku (書く) writes code, Waza (技) drills habits, Kami (紙) delivers documents.

Showcase

Sample PDFs in several formats and languages. Click any preview to open it.

Founder resume
Resume · English
Founder resume, 2 pages 		Kami print one-pager
One-Pager · 中文
Kami 介绍 · 白底打印版 		Tesla equity report
Equity Report · 中文
Tesla Q1 2026 财报点评 		Agent keynote slides
Slides · English
Agent keynote, 8 slides
Mole product brief
One-Pager · English
Mole product brief, 1 page 		Recommendation letter
Letter · 中文
推荐信, 1 页 		Mole release notes
Changelog · English
Mole v1.7.1 release notes 		Kaku portfolio
Portfolio · 日本語
Kaku ターミナル作品集 · 7 ページ

Install

Claude Code, Codex, Cursor, and other agents

npx skills add tw93/kami -a claude-code codex cursor -g -y

One copy lands in ~/.agents/skills, the shared skills directory. Claude Code is symlinked in; Codex, Cursor, and every other agent that reads that directory picks Kami up as /kami. Update with npx skills update -g -y.

Host plugin, if you prefer the host's own update command (namespaced as /kami:kami; Claude Code v2.1.142 or newer)

# Claude Code (update: claude plugin update kami)
/plugin marketplace add tw93/kami
/plugin install kami@kami

# Codex (update: codex plugin marketplace upgrade kami, then codex plugin add kami@kami)
codex plugin marketplace add tw93/kami
codex plugin add kami@kami

Claude Desktop: download the release asset kami.zip, not GitHub's source ZIP, open Customize > Skills > "+" > Create skill, and upload it. To update, click "..." on the skill card, choose Replace, and upload the latest ZIP.

Large CJK fonts stay out of every package: scripts/ensure-fonts.sh recovers missing Chinese or Korean fonts into the user font directory, and in a repository checkout it copies the tracked fonts into the skill so templates load them locally before falling back to the jsDelivr CDN.

Kami also runs a quiet version check at most once a day and tells you in chat when a newer published release is out. It writes a marker in the local XDG cache directory, then resolves GitHub's latest public release; it uploads no user document or task content and fails silently when offline or when no cache home is available.

Use

The skill auto-triggers from natural requests, no slash command needed. Optimized for English and Chinese; Japanese and Korean are supported via language-specific font fallbacks and layout adjustments, with output checked individually.

Example prompts by language:

Brand profile (optional)

Create ~/.config/kami/brand.md to persist identity, brand, defaults, and writing habits. See brand.example.md for a full template.

The file has YAML frontmatter for structured fields like name, role, email, brand color, language, page size, and tone, plus a Markdown body for freeform notes. Kami uses these settings where the current request leaves a choice open; explicit instructions always take priority. Use it to avoid repeating your preferences for each document.

Design

The defaults are a warm parchment background (#f5f4ed), ink-blue accents (#1B365D), and serif fonts. Templates use type size and spacing to separate titles, body text, and notes. You can adjust the defaults for your brand.

Kami picks the right variant based on the language you write in.

Fonts: Each language uses a single serif font for the entire page. Chinese: TsangerJinKai02. Japanese: YuMincho. Korean: Source Han Serif K. English: Charter. See License for font terms.

Full spec: design.md. Cheatsheet: CHEATSHEET.md.

Beyond Documents

The same layout rules also work for landing pages and prompts for AI image tools.

Kami landing page
Kami · landing page
Design system homepage 		Mole landing page
Mole · landing page
macOS system utility 		SpatialVLA architecture redraw
Architecture redraw · English
SpatialVLA Figure 1, schematic 		Tesla Optimus patent overview
Evidence layout · 中文
Tesla Optimus 专利图一览

Landing pages ship as deployable multilingual sites. Illustrations use the host's own image generation when that capability is available; otherwise Kami outputs the same complete brief for use in an image model.

Redraw this as a clean editorial diagram. Background: warm parchment (#f5f4ed), never pure white. One accent only, ink blue (#1B365D); everything else in warm gray with a yellow-brown undertone, no other colors. Thin single-line geometric strokes and simple flat icons. No gradients, no drop shadows, no 3D. Labels in a serif typeface. Generous whitespace, calm and composed, like a figure in a well-typeset report.

Rendered by ChatGPT Images in a single pass with no manual touch-up. Kami specifies, the renderer draws.

Background

I like investing in US equities and ask Claude to write research reports all the time. Every output landed in the same default-doc look: gray, flat, a different layout each session. The structure was hard to scan, the formatting felt dated, and nothing about the page made me want to keep reading. So I started fixing the typography, the palette, the spacing, one rule at a time, until the report became a page I actually enjoyed.

Later I needed to present "The Agent You Don't Know: Principles, Architecture and Engineering Practice." I already had the document and didn't want to build slides from scratch, so I used Claude Design to lay it out in my own style, tweaked it round after round, and eventually got it to a place I was happy with. That process added inline SVG charts, a unified warm palette, and a tighter editorial rhythm. It kept growing until it covered every document I regularly ship, so I collected the templates and rules into Kami.

Support

These lovely people already did 🐱

License

MIT License for kami code and templates. Feel free to use and contribute.

Fonts: TsangerJinKai02 is free for personal use only; commercial use requires a license from tsanger.cn. Charter, YuMincho, Source Han Serif K under OFL, and CJK fallbacks are system-bundled or open-licensed.

Kami (tw93/Kami)

korean
Searching Database…

12K ·GitHub
Kami
What is this?Kami is an agent skill that gives AI coding agents (Claude Code, Codex, Cursor, etc.) templates and layout rules to turn plain requests into polished documents and landing pages — PDFs, PNGs, or editable PowerPoint slides.
Is this an app I run, or a skill my AI agent uses?It is not a standalone app — it's a skill package of templates, scripts, and a small MCP server that lands in your agent's shared skills folder and auto-triggers when you ask for a document, no slash command needed.
How do I install Kami?Install it with 'npx skills update -g -y', which places a copy in the shared ~/.agents/skills directory that Claude Code, Codex, Cursor, and other skill-reading agents pick up automatically as /kami; Claude Desktop users instead download the kami.zip release asset and upload it under Customize > Skills.
Which agents and tools does it need to work?It needs a skills-aware AI agent (Claude Code, Codex, Cursor, Claude Desktop, or any MCP-capable agent); PDF rendering uses WeasyPrint by default, python-pptx handles editable slide export, and Pygments is optional for code syntax highlighting.
Any catches with fonts or licensing?Large CJK fonts aren't bundled and must be recovered with scripts/ensure-fonts.sh; the default Chinese font TsangerJinKai02 is free for personal use only and needs a commercial license from tsanger.cn for business use.
Does Kami send my documents anywhere?No — its daily version check only writes a local marker and queries GitHub's public release info; it never uploads document or task content and fails silently if offline.
What templates does Kami include out of the box?Eight document templates — One-Pager, Long Doc, Letter, Portfolio, Resume, Slides, Equity Report, and Changelog — plus a landing-page system, available in English, Chinese, and Korean.
Can it draw diagrams, not just text?Yes, it has eighteen inline SVG diagram types, and sequence, class, and ER diagrams can be authored from Mermaid text that gets re-themed to Kami's warm palette.
Why did the author build Kami instead of relying on default AI-generated docs?The author got tired of AI research reports and slides always looking gray, flat, and differently laid out each session, so they built reusable typography, palette, and layout rules and packaged them as Kami.
What is Mole, mentioned alongside Kami?Mole is the author's separate paid Mac cleanup app, promoted alongside Kami; Kami is also one-third of a trilogy with Kaku (writes code) and Waza (drills habits).
What are similar projects?baoyu-design, dashi-ppt-skill, visual-explainer, ppt-master, gzh-design-skill, huashu-design, rhwp, SenseNova-Skills
Which topics is it in?typesetting, landing-page, korean, japanese, pptx, slides, template, agent-skill, document-processing, svg, i18n, multilingual
Creator
tw93
Size
180.3 MB
Stars
12K
Updated
CommitOct 15ReleaseV1.18.0Oct 15
Age
5mo
Commits · 90 Days