Kami:为 AI 智能体提供文档与落地页排版模板的开源 Skill
Kami(日语「紙」)是 tw93 开源的 AI 智能体 Skill,为文档与落地页提供模板和排版规则:可生成 PDF、PNG,按需导出可编辑 PPTX,也可输出 Markdown 优先的 Marp 演示稿。内置八种文档模板、一套落地页系统,以及内容与版式检查;支持 Claude Code、Codex、Cursor、Claude Desktop 等智能体,并提供零依赖 MCP 服务器作为渲染引擎。
社区作者 · zZz
它解决什么问题
Kami 的定位是给 AI 智能体提供「文档与落地页的模板与排版规则」。它可以直接产出 PDF 与 PNG,也可以把幻灯片导出为可编辑的 PowerPoint 文件。
项目名 Kami(紙/かみ)在日语中意为「纸」。它是作者「三部曲」的一部分:Kaku(書く)写代码,Waza(技)练习惯,Kami(紙)交付文档。
主要能力
- 模板:八种文档模板——One-Pager(一页纸)、Long Doc(长文档)、Letter(信件)、Portfolio(作品集)、Resume(简历)、Slides(幻灯片)、Equity Report(财报点评)、Changelog(更新日志),外加一套 Landing Page 落地页系统,覆盖 EN、CN、KO。
- 图表:十八种内联 SVG 类型,包含报告级架构图版式;Sequence、Class、ER 可由 Mermaid 文本编写,beautiful-mermaid 渲染 SVG,再由 scripts/mermaid_normalize.py 重新套用 Kami 配色并使其对 WeasyPrint 安全,不捆绑 Node。
- 幻灯片三条渲染路径:默认 WeasyPrint 把 HTML 转 PDF;按请求用 python-pptx 生成可编辑 PPTX;以及位于 assets/templates/marp/ 的 Marp 变体,面向 Markdown 优先的演示稿。
- 代码:安装 Pygments 时做基于 Pygments 的语法高亮;未安装时 PDF 仍能渲染,代码保持单色。
- 校验:内容 schema 在排版前检查结构;coverage 检查查找填充页面上缺失的内容。结构化 brief 记录受众与需求,页面图像用于最终视觉审查。
- MCP:零依赖 MCP 服务器(skills/kami/scripts/mcp_server.py)暴露能力诊断、渲染、结构化检查和截图工具,任何支持 MCP 的智能体都能把 Kami 当作引擎驱动,而无需加载完整 skill 提示词。注意:仅渲染可信的本地 HTML——被引用的 file、HTTP、HTTPS 资源会以 MCP 进程的权限加载。
- 打印:羊皮纸色为默认画布;可选的 white-paper 变体把任意文档翻转为白底,便于家用或办公打印机,卡片与表格仍保留暖色背景。中文版一页纸 Kami 介绍即用该变体渲染,配方见 production.md。
设计风格:默认暖羊皮纸底色(#f5f4ed)、墨蓝点缀色(#1B365D)、衬线字体;模板用字号与间距区分标题、正文与注释,可按品牌调整。字体按语言各用一种衬线字体:中文 TsangerJinKai02、日文 YuMincho、韩文 Source Han Serif K、英文 Charter。完整规范见 design.md,速查见 CHEATSHEET.md。Kami 会根据你书写所用的语言挑选合适变体。
展示样例(配图 2 至配图 9 依次为示例):创始人简历(英文,2 页)、Kami 介绍一页纸(中文,白底打印版)、Tesla Q1 2026 财报点评(中文)、Agent 主题演讲幻灯片(英文,8 页)、Mole 产品简报一页纸(英文,1 页)、推荐信(中文,1 页)、Mole v1.7.1 更新日志(英文)、Kaku 终端作品集(日语,7 页)。配图 1 为项目 logo。
文档之外:同一套排版规则也适用于落地页与 AI 图像工具提示词(配图 10 Kami 落地页、配图 11 Mole 落地页、配图 12 SpatialVLA 架构重绘)。落地页以可部署的多语言站点形式交付。插图优先使用宿主自身的图像生成能力;若不可用,Kami 输出同一份完整 brief 供图像模型使用。作者给出的示例中,架构重绘由 ChatGPT Images 一次生成、无手工修饰——Kami 负责规定,渲染器负责绘制。
背景:作者长期用 Claude 写美股研究报告,输出总是同一副默认文档模样,结构
— 本文由 AI 根据公开来源辅助整理,命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
Install Claude Code, Codex, Cursor, and other agents
npx skills add tw93/kami -a claude-code codex cursor -g -yOne 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:
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 appBrand 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 Design system homepage Mole · landing page macOS system utility Architecture redraw · English SpatialVLA Figure 1, schematic 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.
- 中文: 帮我做一份一页纸 / 帮我排版一份长文档 / 帮我写一封正式信件 / 帮我做一份作品集 / 帮我做一份简历 / 帮我做一套演讲幻灯片 / 帮我做一份 Markdown 风格的演示稿 / 帮我做一个产品落地页
- 日本語: スタートアップ向けの一枚資料を作って / この調査を長文レポートに整えて / 正式な依頼文を作って / プロジェクト作品集を作って / 履歴書を作って / 登壇用スライドを作って / Marp で登壇スライドを作って / アプリのランディングページを作って
- 한국어: 스타트업 원페이저를 만들어줘 / 이 리서치를 장문 문서로 정리해줘 / 정식 레터를 작성해줘 / 프로젝트 포트폴리오를 만들어줘 / 이력서를 만들어줘 / 발표용 슬라이드를 만들어줘 / Marp 슬라이드로 만들어줘 / 앱 랜딩 페이지를 만들어줘
- Templates. Eight document templates: One-Pager, Long Doc, Letter, Portfolio, Resume, Slides, Equity Report, and Changelog, plus a Landing Page system, in EN, CN, and KO.
- Diagrams. Eighteen inline SVG types, including a report-scale architecture board. Sequence, class, and ER can be authored from Mermaid text: beautiful-mermaid renders the SVG and scripts/mermaid_normalize.py re-themes it to the Kami palette and makes it WeasyPrint-safe, no Node bundled.
- Slides. Three rendering paths: WeasyPrint HTML to PDF by default, python-pptx for editable PPTX on request, and a Marp variant in assets/templates/marp/ for Markdown-first decks.
- Code. Pygments-based syntax highlighting when Pygments is installed; without it, PDFs still render and code stays monochrome.
- 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.
- 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.
- 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 (Chinese) is rendered with this variant; recipe in production.md .
- The most direct way to support me is getting Mole for Mac , my paid Mac cleanup app.
- If Kami helped you, give it a star, share it , or open an issue or PR.
- I have two cats, TangYuan and Coke. If Kami has been useful, you can feed them canned food 🥩 .