Skip to content
Back to search

kami

Document typesetting skill for Claude Code.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tw93--kami/badge.svg)](/listings/tw93--kami)

HTML

<a href="/listings/tw93--kami"><img src="/api/listings/tw93--kami/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**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`.

Or ask your agent: > Install Kami for me by reading https://kami.tw93.fun/llms.txt

**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](https://github.com/tw93/kami/releases/latest/download/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: `skills/kami/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.

On Windows, run Kami inside WSL (Ubuntu): the helper scripts are Bash, and WeasyPrint on native Windows also needs the GTK/Pango runtime installed separately.

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.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 18 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "kami",
  3. "description": "Document typesetting skill for Claude Code.",
  4. "owner": {
  5. "name": "Tw93",
  6. "email": "hitw93@gmail.com"
  7. },
  8. "plugins": [
  9. {
  10. "name": "kami",
  11. "version": "1.20.0",
  12. "description": "Typeset professional documents and landing pages with the Kami design system.",
  13. "category": "documents",
  14. "source": "./plugins/kami",
  15. "homepage": "https://github.com/tw93/kami"
  16. }
  17. ]
  18. }
README.md · README · 235 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <img src="skills/kami/assets/images/logo.svg" width="120" />
  3. <h1>Kami</h1>
  4. <p><b>Good content deserves good paper.</b></p>
  5. <p>English · <a href="README_CN.md">中文</a> · <a href="README_TW.md">繁體</a> · <a href="README_JA.md">日本語</a> · <a href="README_KR.md">한국어</a> · <a href="README_DE.md">Deutsch</a> · <a href="README_FR.md">Français</a></p>
  6. <a href="https://github.com/tw93/kami/stargazers"><img src="https://img.shields.io/github/stars/tw93/kami?style=flat-square" alt="Stars"></a>
  7. <a href="https://github.com/tw93/kami/releases"><img src="https://img.shields.io/github/v/tag/tw93/kami?label=version&style=flat-square" alt="Version"></a>
  8. <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square" alt="License"></a>
  9. <a href="https://x.com/HiTw93"><img src="https://img.shields.io/badge/follow-Tw93-red?style=flat-square&logo=x" alt="Twitter"></a>
  10. </div>
  11. ## Why
  12. Kami (紙, かみ) means "paper" in Japanese. It gives AI agents layout rules and templates for PDF, PNG, and editable PowerPoint output, with nine built-in document templates and a product landing page.
  13. As the delivery piece of the trilogy, Kami works alongside [Kaku](https://github.com/tw93/Kaku) (書く), built for writing code, and [Waza](https://github.com/tw93/Waza) (技), built around engineering habits, so technical work is not only logically rigorous but also visually compelling.
  14. ## Showcase
  15. Sample PDFs in several formats and languages. Click any preview to open it.
  16. <table>
  17. <tr>
  18. <td align="center" width="25%">
  19. <a href="site/assets/demos/demo-musk-resume.pdf"><img src="site/assets/demos/demo-musk-resume.png" alt="Founder resume"></a>
  20. <br><b>Resume</b> · English
  21. <br><sub>Founder resume, 2 pages</sub>
  22. </td>
  23. <td align="center" width="25%">
  24. <a href="site/assets/demos/demo-kami-print.pdf"><img src="site/assets/demos/demo-kami-print.png" alt="Kami print one-pager"></a>
  25. <br><b>One-Pager</b> · 中文
  26. <br><sub>Kami 介绍 · 白底打印版</sub>
  27. </td>
  28. <td align="center" width="25%">
  29. <a href="site/assets/demos/demo-tesla.pdf"><img src="site/assets/demos/demo-tesla.png" alt="Tesla equity report"></a>
  30. <br><b>Equity Report</b> · 中文
  31. <br><sub>Tesla Q1 2026 财报点评</sub>
  32. </td>
  33. <td align="center" width="25%">
  34. <a href="site/assets/demos/demo-agent-slides.pdf"><img src="site/assets/demos/demo-agent-slides.png" alt="Agent keynote slides" /></a>
  35. <br><b>Slides</b> · English
  36. <br><sub>Agent keynote, 8 slides</sub>
  37. </td>
  38. </tr>
  39. <tr>
  40. <td align="center" width="25%">
  41. <a href="site/assets/demos/demo-mole.pdf"><img src="site/assets/demos/demo-mole.png" alt="Mole product brief"></a>
  42. <br><b>One-Pager</b> · English
  43. <br><sub>Mole product brief, 1 page</sub>
  44. </td>
  45. <td align="center" width="25%">
  46. <a href="site/assets/demos/demo-letter.pdf"><img src="site/assets/demos/demo-letter.png" alt="Recommendation letter"></a>
  47. <br><b>Letter</b> · 中文
  48. <br><sub>推荐信, 1 页</sub>
  49. </td>
  50. <td align="center" width="25%">
  51. <a href="site/assets/demos/demo-changelog.pdf"><img src="site/assets/demos/demo-changelog.png" alt="Mole release notes"></a>
  52. <br><b>Changelog</b> · English
  53. <br><sub>Mole v1.7.1 release notes</sub>
  54. </td>
  55. <td align="center" width="25%">
  56. <a href="site/assets/demos/demo-kaku.pdf"><img src="site/assets/demos/demo-kaku.png" alt="Kaku portfolio"></a>
  57. <br><b>Portfolio</b> · 日本語
  58. <br><sub>Kaku ターミナル作品集 · 7 ページ</sub>
  59. </td>
  60. </tr>
  61. </table>
  62. ## Social Cards
  63. Image cards for Instagram and X, in eight paper colors. The four below use what I posted about my own products. Click any card to see it full size.
  64. <table>
  65. <tr>
  66. <td align="center" width="25%">
  67. <a href="site/assets/demos/demo-social-cards-mole-en.jpg"><img src="site/assets/demos/demo-social-cards-mole-en.jpg" alt="Mole cover card"></a>
  68. <br><b>Mole</b>
  69. <br><sub>Cover, ink paper</sub>
  70. </td>
  71. <td align="center" width="25%">
  72. <a href="site/assets/demos/demo-social-cards-kaku-en.jpg"><img src="site/assets/demos/demo-social-cards-kaku-en.jpg" alt="Kaku list card"></a>
  73. <br><b>Kaku</b>
  74. <br><sub>List, pine paper</sub>
  75. </td>
  76. <td align="center" width="25%">
  77. <a href="site/assets/demos/demo-social-cards-pake-en.jpg"><img src="site/assets/demos/demo-social-cards-pake-en.jpg" alt="Pake text card"></a>
  78. <br><b>Pake</b>
  79. <br><sub>Text, crimson paper</sub>
  80. </td>
  81. <td align="center" width="25%">
  82. <a href="site/assets/demos/demo-social-cards-miaoyan-en.jpg"><img src="site/assets/demos/demo-social-cards-miaoyan-en.jpg" alt="MiaoYan screenshot card"></a>
  83. <br><b>MiaoYan</b>
  84. <br><sub>Screenshot, char paper</sub>
  85. </td>
  86. </tr>
  87. </table>
  88. ## Install
  89. **Claude Code, Codex, Cursor, and other agents**
  90. ```bash
  91. npx skills add tw93/kami -a claude-code codex cursor -g -y
  92. ```
  93. 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`.
  94. Or ask your agent:
  95. > Install Kami for me by reading https://kami.tw93.fun/llms.txt
  96. **Host plugin**, if you prefer the host's own update command (namespaced as `/kami:kami`, Claude Code v2.1.142 or newer):
  97. ```bash
  98. # Claude Code (update: claude plugin update kami)
  99. /plugin marketplace add tw93/kami
  100. /plugin install kami@kami
  101. # Codex (update: codex plugin marketplace upgrade kami, then codex plugin add kami@kami)
  102. codex plugin marketplace add tw93/kami
  103. codex plugin add kami@kami
  104. ```
  105. **Claude Desktop**: download the release asset [kami.zip](https://github.com/tw93/kami/releases/latest/download/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.
  106. Large CJK fonts stay out of every package: `skills/kami/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.
  107. On Windows, run Kami inside WSL (Ubuntu): the helper scripts are Bash, and WeasyPrint on native Windows also needs the GTK/Pango runtime installed separately.
  108. 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.
  109. ## Use
  110. ### Supported Languages
  111. English and Chinese have the most complete support. Japanese and Korean use language-specific font fallbacks and layout adjustments, with each output checked before delivery. Each language uses a single serif font for the whole page, with font terms under [License](#license):
  112. | Language | Support Level | Default Serif Font |
  113. | :--- | :--- | :--- |
  114. | **English** | Complete | Charter |
  115. | **Chinese** (简体 / 繁體) | Complete | TsangerJinKai02 (仓耳今楷) |
  116. | **Japanese** (日本語) | Font fallbacks & layout check | YuMincho (游明朝) |
  117. | **Korean** (한국어) | Font fallbacks & layout check | Source Han Serif K (본명조) |
  118. The skill auto-triggers from natural requests, no slash command needed. Example prompts by language:
  119. - 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`
  120. - 中文: `帮我做一份一页纸` / `帮我排版一份长文档` / `帮我写一封正式信件` / `帮我做一份作品集` / `帮我做一份简历` / `帮我做一套演讲幻灯片` / `帮我做一份 Markdown 风格的演示稿` / `帮我做一个产品落地页`
  121. - 日本語: `スタートアップ向けの一枚資料を作って` / `この調査を長文レポートに整えて` / `正式な依頼文を作って` / `プロジェクト作品集を作って` / `履歴書を作って` / `登壇用スライドを作って` / `Marp で登壇スライドを作って` / `アプリのランディングページを作って`
  122. - 한국어: `스타트업 원페이저를 만들어줘` / `이 리서치를 장문 문서로 정리해줘` / `정식 레터를 작성해줘` / `프로젝트 포트폴리오를 만들어줘` / `이력서를 만들어줘` / `발표용 슬라이드를 만들어줘` / `Marp 슬라이드로 만들어줘` / `앱 랜딩 페이지를 만들어줘`
  123. **Brand profile** (optional)
  124. Create `~/.config/kami/brand.md` to persist identity, brand, defaults, and writing habits, so you don't repeat your preferences for each document. 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. See [brand.example.md](skills/kami/references/brand.example.md) for a full template.
  125. ## Design
  126. 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.
  127. - **Templates.** Nine document templates: One-Pager, Long Doc, Letter, Portfolio, Resume, Slides, Equity Report, Changelog, and Social Cards, plus a Landing Page system, in EN, CN, and KO. Kami picks the right variant based on the language you write in.
  128. - **Diagrams.** Eighteen inline SVG types, including a report-scale architecture board. Sequence, class, and ER can be authored from Mermaid text: [beautiful-mermaid](https://github.com/lukilabs/beautiful-mermaid) renders the SVG and `skills/kami/scripts/mermaid_normalize.py` re-themes it to the Kami palette and makes it WeasyPrint-safe, no Node bundled.
  129. - **Slides.** Three rendering paths: WeasyPrint HTML to PDF by default, python-pptx for editable PPTX on request, and a Marp variant in `skills/kami/assets/templates/marp/` for Markdown-first decks.
  130. - **Code.** Pygments-based syntax highlighting when `Pygments` is installed; without it, PDFs still render and code stays monochrome.
  131. - **Verification.** Content schemas check structure before layout; coverage checks look for content missing from the filled page. A structured brief records the audience and requirements, and page images support the final visual review.
  132. - **MCP.** A zero-dependency MCP server (`skills/kami/scripts/mcp_server.py`) exposes capability diagnosis, render, structured check, and screenshot tools, so any MCP-capable agent can drive Kami as an engine without loading the full skill prompt. Render only trusted local HTML: referenced file, HTTP, and HTTPS resources load with the MCP process's permissions.
  133. - **Print.** Parchment is the default canvas; an opt-in white-paper variant flips any document to a white background for home or office printers, keeping warm backgrounds in cards and tables. The [one-page Kami intro](site/assets/demos/demo-kami-print.pdf) (Chinese) is rendered with this variant; recipe in [production.md](skills/kami/references/production.md).
  134. - **Social cards.** Image cards for Instagram and X, one 1242x1660 page each, on eight papers that each carry a single accent, one paper per set. Delivery checks every card for text that outgrows it, runs onto the photo, or ends on a line of one or two characters. The author's words never change; line breaks are fixed with layout.
  135. Full spec: [design.md](skills/kami/references/design.md). Cheatsheet: [CHEATSHEET.md](skills/kami/CHEATSHEET.md).
  136. ## Beyond Documents
  137. <table>
  138. <tr>
  139. <td align="center" width="33%" valign="top">
  140. <a href="https://pake.run"><img src="site/assets/showcase/pake-landing-en.png" alt="Pake landing page" height="150"></a>
  141. <br><b>Pake</b> · landing page
  142. <br><sub>Websites as desktop apps</sub>
  143. </td>
  144. <td align="center" width="33%" valign="top">
  145. <a href="https://miaoyan.app"><img src="site/assets/showcase/miaoyan-landing-en.png" alt="MiaoYan landing page" height="150"></a>
  146. <br><b>MiaoYan</b> · landing page
  147. <br><sub>Light Markdown notebook</sub>
  148. </td>
  149. <td align="center" width="33%" valign="top">
  150. <a href="https://mole.fit"><img src="site/assets/showcase/mole-landing-en.png" alt="Mole landing page" height="150"></a>
  151. <br><b>Mole</b> · landing page
  152. <br><sub>Mac cleaner and system tool</sub>
  153. </td>
  154. </tr>
  155. </table>
  156. <table>
  157. <tr>
  158. <td align="center" width="50%" valign="top">
  159. <img src="site/assets/illustrations/travel-spatialvla.png" alt="SpatialVLA architecture redraw" height="150">
  160. <br><b>Architecture redraw</b> · English
  161. <br><sub>SpatialVLA Figure 1, schematic</sub>
  162. </td>
  163. <td align="center" width="50%" valign="top">
  164. <img src="site/assets/illustrations/travel-tesla-optimus.png" alt="Tesla Optimus patent overview" height="150">
  165. <br><b>Evidence layout</b> · 中文
  166. <br><sub>Tesla Optimus 专利图一览</sub>
  167. </td>
  168. </tr>
  169. </table>
  170. The same layout rules also work for landing pages and prompts for AI image tools. 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.
  171. ```text
  172. 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.
  173. ```
  174. <sub>The two illustrations above were rendered by ChatGPT Images in a single pass, with no manual touch-up.</sub>
  175. ## Background
  176. 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.
  177. 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.
  178. ## Support
  179. - The most direct way to support me is getting [Mole for Mac](https://mole.fit), my paid Mac cleanup app
  180. - If Kami helped you, give it a star, [share it](https://x.com/intent/tweet?url=https://github.com/tw93/kami&text=Kami%20-%20A%20quiet%20design%20system%20for%20professional%20documents.), or open an issue or PR
  181. - I have two cats, TangYuan and Coke, and if Kami has been useful, you can feed them <a href="https://cats.tw93.fun?name=Kami" target="_blank">canned food 🥩</a>
  182. These lovely people already did 🐱
  183. <a href="https://cats.tw93.fun?name=Kami"><img src="https://raw.githubusercontent.com/tw93/sponsors/main/assets/sponsors.svg" width="1000" loading="lazy" /></a>
  184. ## License
  185. MIT License for Kami code and templates. Please feel free to use and contribute to the development.
  186. **Fonts**: TsangerJinKai02 is free for personal use only; commercial use requires a license from [tsanger.cn](https://tsanger.cn). Source Han Serif K and JetBrains Mono are under the OFL. Charter and YuMincho come from the operating system and are not shipped with Kami; CJK fallbacks are system-bundled or open-licensed.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.