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)

Searching Database…

12K ·GitHub
Kami
Что это такое?Kami — это навык для ИИ-агента, который даёт агентам для написания кода (Claude Code, Codex, Cursor и др.) шаблоны и правила вёрстки, чтобы превращать простые запросы в аккуратные документы и лендинги: PDF, PNG или редактируемые слайды PowerPoint.
Это приложение, которое я запускаю, или навык, которым пользуется мой ИИ-агент?Это не самостоятельное приложение, а пакет навыка из шаблонов, скриптов и небольшого MCP-сервера. Он попадает в общую папку навыков вашего агента и срабатывает автоматически, когда вы просите подготовить документ; команду с косой чертой вводить не нужно.
Как установить Kami?Установите его командой 'npx skills update -g -y': она создаст копию в общей папке ~/.agents/skills, которую Claude Code, Codex, Cursor и другие агенты, умеющие читать навыки, автоматически подхватывают как /kami. Пользователи Claude Desktop вместо этого скачивают архив kami.zip из релиза и загружают его в разделе Customize > Skills.
Какие агенты и инструменты нужны для работы?Нужен ИИ-агент с поддержкой навыков (Claude Code, Codex, Cursor, Claude Desktop или любой агент с поддержкой MCP). Для отрисовки PDF по умолчанию используется WeasyPrint, экспорт редактируемых слайдов обеспечивает python-pptx, а Pygments необязателен и нужен только для подсветки синтаксиса кода.
Есть ли подводные камни со шрифтами или лицензией?Крупные шрифты CJK не входят в пакет, их нужно получить с помощью скрипта scripts/ensure-fonts.sh. Китайский шрифт TsangerJinKai02 по умолчанию бесплатен только для личного использования, а для коммерческого применения нужна лицензия от tsanger.cn.
Kami отправляет мои документы куда-нибудь?Нет. Ежедневная проверка версии лишь записывает локальную отметку и запрашивает публичную информацию о релизах на GitHub. Содержимое документов и задач никуда не передаётся, а при отсутствии интернета проверка молча завершается без ошибки.
Какие шаблоны есть в Kami сразу после установки?Восемь шаблонов документов — One-Pager, Long Doc, Letter, Portfolio, Resume, Slides, Equity Report и Changelog — а также система для лендингов. Доступны на английском, китайском и корейском языках.
Умеет ли он рисовать диаграммы, а не только текст?Да, есть восемнадцать типов встроенных SVG-диаграмм. Диаграммы последовательностей, классов и ER можно написать на языке Mermaid, и они будут перекрашены в тёплую палитру Kami.
Зачем автор создал Kami, а не пользовался стандартными документами от ИИ?Автору надоело, что исследовательские отчёты и слайды, сделанные ИИ, всегда выглядят серыми и плоскими и каждый раз оформлены по-разному. Поэтому он создал многократно используемые правила типографики, палитры и вёрстки и упаковал их в Kami.
Что такое Mole, которое упоминается рядом с Kami?Mole — отдельное платное приложение автора для очистки Mac, которое продвигается вместе с Kami. Kami также входит в трилогию как одна из трёх частей вместе с Kaku (пишет код) и Waza (тренирует привычки).
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