V1.7.0 Korean Paper

Kami

Korean templates, steadier packaging, and sharper slide guidance.

Changelog

1. Added a dedicated Korean template family across documents, decks, and landing pages, with KO resume demo and public SEO coverage.
2. Added optional brand-profile logo slots for one-pager, portfolio, and WeasyPrint slides without changing the default visual path.
3. Moved large CJK font recovery outside the skill package and clarified Chinese / Korean font fallback for Claude Desktop installs.
4. Hardened palette and token checks with off-palette lint, Marp token coverage, and CN / EN / KO root consistency checks.
5. Refined slide and product-site guidance around ghost deck tests, one evidence shape per slide, screenshot slot planning, and material gaps.
6. Aligned release readiness surfaces: public template counts, package docs, PT-Serif fallback verification, deterministic zip packaging, and final tag timing.

更新日志

1. 新增完整韩语模板族，覆盖文档、幻灯片和落地页，并补齐 KO 简历 demo 与公开站点 SEO 展示。
2. 为一页纸、作品集和 WeasyPrint 幻灯片加入可选品牌 logo 槽位，同时保持默认视觉路径不变。
3. 将大型 CJK 字体恢复移到 skill 包之外，并补清 Claude Desktop 安装时的中文 / 韩文字体 fallback 说明。
4. 加强调色与 token 检查，新增 off-palette lint、Marp token 覆盖，以及 CN / EN / KO root 一致性检查。
5. 收紧幻灯片和产品站点规则，加入 ghost deck test、单页单证据、截图槽位规划和素材缺口处理。
6. 对齐发布前真相面：公开模板数量、包说明、PT-Serif fallback 验证、可复现 zip 打包和最终 tag 时机。

Kami V1.6.0 Markdown Stage

Kami V1.6.0

Decks now begin in Markdown, and the same quiet rules carry them to PDF, PPTX, or the browser.

Changelog

1. Marp Slide Deck Variant: a new Markdown-first deck path (EN/CN) under assets/templates/marp/. One .md source renders to HTML, PDF, or PPTX via marp-cli, and the theme CSS is self-contained, carrying the full Kami token set (parchment, ink-blue, serif rhythm). It joins WeasyPrint HTML-to-PDF (default) and python-pptx (editable) as a third, user-triggered slide path. Kami's own build pipeline does not call marp; users run marp-cli themselves.
2. Landing-Page Production Companion Files: five .example scaffolding files for shipping a generated landing page as a real multilingual site, llms.txt + llms-full.txt for AI assistants, robots.txt with an AI allowlist, sitemap.xml with hreflang, and vercel.json for rewrites and headers. Documented in SKILL.md and packaged in the skill.
3. Site Reaches Five Languages: the official site adds Traditional Chinese and Korean pages alongside English, Simplified Chinese, and Japanese, with a collapsible language switcher that auto-detects the browser language.
4. Scripts Split + Real Render CI: build.py dropped from 1062 to 361 lines, split into focused lint / checks / verify / tokens / optional_deps modules. A new verify-render CI job installs WeasyPrint plus Noto CJK and actually renders the strict-page-count templates, so page-count regressions can no longer slip through lint-only CI. The overflow solver gains end-to-end tests.
5. Robustness & CI Hardening: render verification now accepts DejaVu / Liberation as a serif fallback and adds a KAMI_ALLOW_FALLBACK_ONLY opt-in so CI (which never has commercial fonts) can still gate page counts; the build warns clearly when Pygments is missing; Marp deck visuals tightened.

更新日志

1. Marp 幻灯片: 多了一条用 Markdown 写幻灯片的路子(中英文),放在 assets/templates/marp/。同一份 .md 用 marp-cli 就能导出 HTML、PDF 或 PPTX,主题样式自成一体,内置整套 Kami 配色和字体节奏,不用再配额外 CSS。加上默认的 WeasyPrint(HTML 转 PDF)和 python-pptx(可编辑 PPT),出片现在有三种方式,按需挑一个。Kami 自己的构建流程不碰 marp,要用时本地跑一下 marp-cli 就行。
2. 落地页上线配套文件: 新增五个 .example 脚手架,帮你把生成的落地页真正部署成多语言站点:给 AI 助手读的 llms.txt 和 llms-full.txt、带 AI 抓取白名单的 robots.txt、带 hreflang 的 sitemap.xml,以及管 rewrite 和响应头的 vercel.json。SKILL.md 里有说明,也一并打进了 skill 包。
3. 官网支持五种语言: 在英文、简体中文、日文之外,新增繁体中文和韩文页面,配了个可折叠的语言切换器,会按浏览器语言自动跳转。
4. 脚本拆分 + 渲染级 CI: build.py 从 1062 行瘦到 361 行,拆成职责清楚的 lint、checks、verify、tokens、optional_deps 五个模块。新增的 verify-render 任务会装上 WeasyPrint 和 Noto CJK,把限定页数的模板真正渲染一遍,页数超标再也绕不过只跑 lint 的 CI。溢出 solver 也补齐了端到端测试。
5. 稳健性和 CI 加固: 渲染校验现在认 DejaVu、Liberation 作为 serif 回退,还加了 KAMI_ALLOW_FALLBACK_ONLY 开关,让本来没有商业字体的 CI 也能卡页数;缺 Pygments 时构建会直接提示;顺手收紧了 Marp 幻灯片的视觉细节。

---

Kami is a quiet design system for professional documents, one constraint set that any agent can trust. https://github.com/tw93/Kami

V1.5.0 Live Paper

Kami V1.5.0

From documents to landing pages, the same quiet rules now work on screen.

Changelog

1. Landing Page Template + Showcase: new screen-first template (EN/CN) with interactive gallery, hero, features, principles, pricing, FAQ, and footer. Direction-aware transitions, auto-rotating carousel, 3 responsive breakpoints. Official site adds a "Built with Kami" section showing three live products (Kami, Luo, Mole) from the same template, with browser language auto-detection (EN/ZH/JA) and OG image upgrade.
2. Template Pattern Distillation: absorbed five patterns from the Mole landing page into Kami templates: italic poetic captions on gallery and feature subtitles, FAQ tail paragraph, editorial footer with middot-separated links and italic ethos sign-off, eyebrow version link slot.
3. Syntax Highlighting: code blocks with class="language-*" now get Pygments-based coloring at build time using existing Kami color tokens. No external CSS required. Closes #20.
4. Writing Specs from PPT Experience: 3 new anti-patterns covering caption flow restatement, AI tone cliches with self-check grep, and sans CJK fallback clash. 2 new writing principles covering term annotation half-life and English term density cap in CJK text.
5. Screen-Scale Specs: CJK serif body line-height 1.55-1.65 at slide scale, slide caption floor 24px, diagram SVG fill >=65% on 1080p. Olive confirmed safe for zh-CN TsangerJinKai02 without override.
6. Behind the Scenes: --verify now surfaces advisory density warnings for sparse pages. Rhythm tokens standardize multi-page template spacing. Per-page density target defined in SKILL.md Step 4.1.

更新日志

1. 落地页模板 + 案例展示: 新增屏幕优先模板（中英文），含交互式 Gallery、Hero、Features、Principles、Pricing、FAQ、Footer 七个 section。方向感知滑动、自动轮播、3 个响应式断点。官网新增 "Built with Kami" 板块，展示同一模板搭建的三款产品（Kami、Luo 落文、Mole 鼹），浏览器语言自动检测跳转，OG image 升级为全页截图。
2. 模板模式沉淀: 从 Mole 落地页吸收五个模式: Gallery 和 Feature 副标题 italic 诗意行、FAQ 收尾段落、编辑式页脚（middot 分隔链接 + italic ethos 签名）、眉栏版本链接 slot。
3. 代码语法高亮: <code> 元素带 class="language-*" 的代码块构建时自动 Pygments 着色，复用 Kami 现有色彩 token，无需外部 CSS。关闭 #20。
4. PPT 实战经验写入规范: 3 条新反模式（caption 禁流程复述、AI 套话自检 grep、Sans + CJK 回退冲突），2 条新写作原则（术语注解半衰期、CJK 正文英文密度上限）。
5. 屏幕尺寸规格补充: 中日文 serif 行高 slide scale 下 1.55-1.65，slide caption 下限 24px，diagram SVG 1080p 填充 >=65%。
6. 工程改进: --verify 稀疏页 advisory 密度警告，多页模板间距 rhythm token 标准化，SKILL.md Step 4.1 定义每页最低密度契约。

---

Kami is a quiet design system for professional documents, one constraint set that any agent can trust. https://github.com/tw93/Kami

V1.4.2 Quiet Rails

Kami V1.4.2

Two visible fixes, with quieter rails behind them.

Changelog

1. Chinese Slides No Longer Garbled — The CN slides-weasy.html font stack now keeps body and table text on TsangerJinKai02, instead of falling into a system sans path that produced unreadable glyphs in some PDF readers (issue #18).

2. Install Path Realigned for Claude Code v2.1.136+ — README, three locale index pages, and llms.txt now lead with the npx skills add route, sidestepping a v2.1.136–138 plugin path regression that breaks /plugin install kami@kami (issue #19, upstream anthropics/claude-code#57570). Existing installs are unaffected.

3. Behind the scenes — CI now runs build.py --check, the test suite, and a smoke build on every push and PR; V* tags auto-build and upload kami.zip. Test suite grew from 12 to 42 cases. --check-density runs ~6× faster on sparse pages when numpy is available.

更新日志

1. 中文幻灯片不再乱码 — 修复 slides-weasy.html 中文字体栈，正文与表格文字稳定在 TsangerJinKai02，不再回退到系统 sans 而在部分 PDF 阅读器上出现乱码（issue #18）。

2. 安装路径调整以适配 Claude Code v2.1.136+ — README、三套 index 与 llms.txt 默认推荐 npx skills add 路径，绕开 v2.1.136–138 的插件路径校验回归（issue #19，上游 anthropics/claude-code#57570）。已有安装不受影响。

3. 工程改动 — CI 在每次 push / PR 跑 build.py --check、测试套件与烟雾构建；V* tag 推送自动构建并上传 kami.zip。测试用例从 12 扩到 42 个。--check-density 在 numpy 可用时稀疏页 ~6× 提速。

---

Kami is a quiet design system for professional documents, one constraint set that any agent can trust. https://github.com/tw93/Kami

V1.4.1 Steadier Hand

Kami V1.4.1

Plugin install fix, macOS WeasyPrint runtime, audit-driven cleanup, and the first test suite.

Changelog

1. Plugin Install Fix: Register Kami via marketplace.json with strict: false so /plugin install kami@kami actually loads in Claude Code.
2. macOS WeasyPrint Runtime: Auto-resolve Homebrew lib paths on both Apple Silicon (/opt/homebrew) and Intel Mac (/usr/local) so cairo and pango load on first run.
3. Documents Now Eight Types: README, three locale index pages, JSON-LD, and llms.txt list Equity Report and Changelog as first-class document types.
4. Diagram & Template Polish: Resume CN @page margin 9mm to 11mm, portfolio-en cover line-height tightened to 1.10, and 14 diagrams re-normalized to spec (font-weight 500, no italic, solid hex pre-blended on parchment).
5. Six New Pitfalls: references/production.md grows from 16 to 22 entries, with CHEATSHEET decision tables cross-referencing each new pitfall.
6. Build Pipeline Tightened: HTML_TEMPLATES lifted into scripts/shared.py as the single source of truth; ensure-fonts.sh portable across bash 3.2+; check commands exit non-zero on bad input.
7. First Test Suite: New scripts/tests/test_build.py with 12 zero-dependency cases covering registry consistency, scan rules, and slide sequence parsing.

更新日志

1. 插件安装修复：把 Kami 注册移到 marketplace.json 并设 strict: false，让 /plugin install kami@kami 在 Claude Code 真正可用。
2. macOS WeasyPrint 运行时：自动识别 Apple Silicon (/opt/homebrew) 与 Intel Mac (/usr/local) 两条 Homebrew 路径，首次构建即可加载 cairo 与 pango。
3. 文档类型扩展到 8 类：README、三套 index、JSON-LD、llms.txt 把 Equity Report 与 Changelog 列为一等公民。
4. 模板与图表打磨：Resume 中文 @page 边距 9mm 调到 11mm，portfolio-en 封面行高收紧到 1.10，14 个图表统一回到规范（font-weight 500、去斜体、rgba 预混到羊皮纸色）。
5. 新增 6 条产线经验：references/production.md 从 16 条扩到 22 条，CHEATSHEET 决策表逐条交叉引用。
6. 构建管线收紧：HTML_TEMPLATES 提到 scripts/shared.py 作单一事实源；ensure-fonts.sh 兼容 bash 3.2+；check 命令在异常输入时退出非零。
7. 首套测试基础设施：新增 scripts/tests/test_build.py，12 个零依赖测试覆盖注册表一致性、扫描规则、幻灯片序列解析。

Kami is a quiet design system for professional documents, one constraint set that any agent can trust. https://github.com/tw93/Kami

V1.4.0 Wider Reach

Kami V1.4.0

Claude Code marketplace support, stronger slide output, and cleaner public visibility.

Changelog

1. Claude Code Plugin: Install Kami through /plugin marketplace add tw93/Kami and /plugin install kami@kami.
2. WeasyPrint Slides: Add default HTML-to-PDF slide templates for Chinese and English decks.
3. AI Visibility: Add llms.txt, robots.txt, sitemap, FAQ JSON-LD, and aligned public install copy.
4. Font Recovery: Add scripts/ensure-fonts.sh for multi-source TsangerJinKai02 recovery with size checks.
5. Brand Profile: Move profiles to ~/.config/kami/brand.md with a public example and clearer layering.
6. Template Quality: Tighten resume, long-doc, equity report, changelog, and slide rendering behavior.
7. Package and Font Hygiene: Slim kami.zip by excluding large Chinese fonts, while keeping TsangerJinKai02 as the preferred Chinese rendering path.

更新日志

1. Claude Code 插件支持：支持通过 /plugin marketplace add tw93/Kami 与 /plugin install kami@kami 安装 Kami。
2. WeasyPrint 幻灯片：新增中英文 HTML-to-PDF 默认幻灯片模板。
3. AI 可见性：新增 llms.txt、robots.txt、sitemap、FAQ JSON-LD，并同步官网安装说明。
4. 字体恢复：新增 scripts/ensure-fonts.sh，支持多源恢复 TsangerJinKai02 并校验文件大小。
5. Brand Profile：迁移到 ~/.config/kami/brand.md，新增公开示例，并明确分层应用规则。
6. 模板质量：收紧 Resume、Long Doc、Equity Report、Changelog 与 Slides 的渲染行为。
7. 包体与字体治理：精简 kami.zip，不内置大型中文字体；中文输出仍优先使用 TsangerJinKai02。

Kami is a quiet design system for professional documents, one constraint set that any agent can trust. https://github.com/tw93/Kami

V1.3.0 Cleaner Edges

Kami V1.3.0

Tighter resume, more deck range, fewer rendering surprises.

Changelog

1. Resume Dense Variant: Add dense to the resume root for compact spacing, plus 7 fixes for class aliases, os-grid alignment, and date nowrap.
2. Slide Layouts: Two new layouts added: funnel for staged flow diagrams and chapter for section covers, expanding deck visual range without custom CSS.
3. Brand Profile Fields: Personal habit, voice, and style fields added for consistent tone across sessions and document types.
4. Travel Block: New shared section that renders from one brief in both slide deck and portfolio image layouts, no duplication needed.
5. Writing Guides: Quality bar guides added for general documents and resume, covering content standards for all eight template types.
6. Typography and Overflow: Fixed font drift and metric label wrap regressions across resume and equity report templates; overflow handling tightened.
7. Layout and Border Fixes: Callout double-border, chapter-01 page break, and funnel stroke corrected; thin border with border-radius combos triggering a WeasyPrint double-ring artifact removed across all templates.

更新日志

1. Resume Dense 变体：为 resume 根元素添加 dense class 即可切换紧凑间距，落地 7 条精修，覆盖 class 别名、os-grid 与日期 nowrap。
2. Slide 布局扩展：新增 funnel 漏斗布局与 chapter 章节封面，无需自定义 CSS 即可扩展 Deck 视觉表达。
3. Brand Profile 字段扩展：新增个人习惯、语气与风格字段，一份 profile 跨会话保持一致的语气与格式。
4. Travel 区块：新增共享区块，同一份内容简介可同时渲染到 Slide 与 Portfolio，无需重复填写。
5. 写作指南：新增通用文档与 Resume 专项写作指南，明确各类模板的内容标准与取舍原则。
6. 字体与溢出修复：修复 Resume 与 equity-report 模板的字体漂移、指标标签换行回归；收紧溢出控制。
7. 布局与边框修复：修复 callout 双边框、chapter-01 分页异常与 funnel 描边问题；全模板清除薄边框配 border-radius 组合，关闭 WeasyPrint 双环渲染。

Kami is a quiet design system for professional documents, one constraint set that any agent can trust. https://github.com/tw93/Kami

V1.2.0 Fewer Decisions

Kami V1.2.0

One quiet design system, fewer decisions, better paper.

Changelog

1. Equity Report & Changelog: Two new document templates for investment analysis (2-3 page ticker/metrics/thesis format) and release notes, both in Chinese and English
2. Candlestick & Waterfall Charts: Two new financial diagram types for stock price history (OHLC) and revenue bridge decomposition, bringing the total to 14 inline SVG diagrams
3. Unified Table Component: All templates now share .kami-table with .compact, .financial, .striped, and .total variants, so tables look consistent across every document type
4. Typography Consolidation: Removed Inter and Newsreader, locked to one serif per page (Charter for English, TsangerJinKai02 for Chinese, YuMincho for Japanese), added Chinese body letter-spacing 0.35px
5. Color Palette Simplification: Consolidated from 11 neutral tokens to 6, migrated olive and stone values across all templates, diagrams, and demos for better readability
6. Auto-Select Charts: The skill now picks the right chart type from data context (proportional -> donut, time series -> line, comparison -> bar) instead of waiting for the user to specify
7. Auto-Select Output Format: PDF always ships, PPTX follows slides, PNG follows sharing context. Users never need to think about export formats
8. Orphan Detection: build.py --check-orphans scans PDFs for orphan text (last line with 1-2 words), catching layout issues before delivery

更新日志

1. 个股研报与更新日志: 新增两种文档模板，个股研报（2-3 页，含行情头、指标卡、投资论点）和更新日志，均支持中英双语
2. K 线图与瀑布图: 新增两种金融图表，K 线用于股价走势（OHLC），瀑布图用于收入桥和估值拆解，内联 SVG 图表总数达到 14 种
3. 统一表格组件: 所有模板共享 .kami-table，支持 .compact、.financial、.striped、.total 四种变体，表格在各类文档中保持一致
4. 字体精简: 去掉 Inter 和 Newsreader，锁定每页一种衬线体（英文 Charter、中文 TsangerJinKai02、日文 YuMincho），中文正文新增 0.35px 字距
5. 色阶精简: 中性色从 11 个 token 收敛到 6 个，olive 和 stone 色值全面迁移，提升可读性
6. 图表自动选择: Skill 现在根据数据上下文自动选择图表类型（占比用环形图、趋势用折线图、对比用柱状图），不再需要用户指定
7. 输出格式自动选择: PDF 始终生成，PPTX 跟随演讲场景，PNG 跟随分享场景，用户不需要考虑导出格式
8. 孤行检测: build.py --check-orphans 扫描 PDF 中的孤行文本（末行仅 1-2 个词），在交付前发现排版问题

Kami is a quiet design system for professional documents, one constraint set that any agent can trust. https://github.com/tw93/Kami

V1.1.0 Good Paper

Kami V1.1.0

Good content deserves good paper.

Changelog

1. Diagram Library: Kami now ships 12 inline SVG diagram types, covering architecture, flowchart, quadrant, bar chart, line chart, donut chart, state machine, timeline, swimlane, tree, layer stack, and Venn diagrams.
2. Browser Preview: All document templates now include an A4 browser preview mode, so layout can be checked before exporting PDF.
3. Homepage Showcase: The website now includes a diagram showcase and Claude Desktop download link, with the section numbering and responsive chart cards updated accordingly.
4. Tesla Demo: The Tesla one-pager demo was rebuilt with metadata, tighter layout, delivery trend bars, revenue structure donut chart, and refreshed PDF / PNG assets.
5. Chinese Typography: Added TsangerJinKai02 W05 for real heading weight, jsDelivr fallback for W04 / W05, and CJK fallback coverage for footers, code blocks, preformatted text, and SVG labels.
6. Claude Desktop Package: dist/kami.zip is now tracked on main, excludes commercial fonts through a git-file manifest, supports font auto-recovery, and can be refreshed in the existing release without creating a new tag.
7. Verification Flow: scripts/build.py now verifies 24 outputs including diagrams and slides, fixes PDF font parsing, separates source-template verification from --check-placeholders, and uses plain OK: / ERROR: status output.
8. Skill and Docs: The skill now routes all 12 diagram types, fills PDF metadata, checks facts and branded materials before drafting, and uses one English reference set instead of duplicated *.en.md files.
9. Writing and Release Guidance: Writing rules now combine the stronger Chinese and English guidance in one file, while CLAUDE.md documents the release refresh flow and Mole-style bilingual release note format.

更新日志

1. 图表库: Kami 现在内置 12 种内联 SVG 图表，覆盖架构图、流程图、象限图、柱状图、折线图、环形图、状态机、时间线、泳道图、树状图、分层图和维恩图。
2. 浏览器预览: 所有文档模板都加入 A4 浏览器预览模式，导出 PDF 前可以先检查版式。
3. 官网展示: 官网新增图表展示区和 Claude Desktop 下载入口，并同步调整章节编号与响应式图表卡片。
4. Tesla 示例: Tesla one-pager 示例重新整理，补充 metadata、收紧版式，加入交付量柱状图和营收结构环形图，并更新 PDF / PNG 产物。
5. 中文排版: 新增 TsangerJinKai02 W05 真实标题字重，W04 / W05 支持 jsDelivr 回退，并为页脚、代码块、pre 文本和 SVG label 补齐 CJK fallback。
6. Claude Desktop 打包: dist/kami.zip 现在作为 tracked artifact 放在 main，通过 git 文件清单排除商业字体，支持字体自动恢复，也可以在现有 release 中原地刷新。
7. 验证流程: scripts/build.py 现在验证 24 个输出，包含图表和 slides，修复 PDF 字体解析，拆分模板源码验证与 --check-placeholders，并统一使用 OK: / ERROR: 状态输出。
8. Skill 与文档: Skill 现在路由全部 12 种图表，要求填充 PDF metadata，撰写前检查事实和品牌素材，并改用一套英文参考文档，不再维护重复的 *.en.md 文件。
9. 写作与发布规则: 写作规则合并中英文版本中更强的约束，CLAUDE.md 记录原地刷新 release 的流程和 Mole 风格双语更新日志格式。

Kami is a quiet design system for professional documents, with bilingual PDF templates, inline SVG diagrams, and Claude / Codex skill support. https://github.com/tw93/Kami

V1.0.0 Kami is born 紙

Kami V1.0.0

The paper your deliverables land on.

What is Kami

Kami is a design system skill for Claude Code, Codex, and Claude Desktop. Tell Claude what you need in natural language, it produces print-ready documents in a warm parchment aesthetic with ink-blue accent, serif-led hierarchy, and editorial whitespace.

Document types

One-Pager, Long Doc, Letter, Portfolio, Resume, and Slides. Each with Chinese and English variants. Three inline SVG diagram primitives: architecture, flowchart, quadrant.

Install

# Claude Code
npx skills add tw93/kami -a claude-code -g -y

# Codex
npx skills add tw93/kami -a codex -g -y

Design highlights

• Warm parchment canvas #f5f4ed, single ink-blue accent #1B365D
• English: Newsreader serif for headlines and body. Chinese: TsangerJinKai02 serif + Source Han Sans
• Serif weight locked at 500, no bold, no italic
• Eight design invariants hold across every document

Kami 是什么

Kami 是一个面向 Claude Code、Codex 和 Claude Desktop 的设计系统技能。用自然语言告诉 Claude 你要什么文档，它会用暖米纸底、油墨蓝点缀、serif 主导层级的排版风格生成可直接打印的专业文档。

文档类型

单页方案、长文档、正式信件、作品集、简历、演示文稿，各有中英文版本。另附三种 SVG 图表: 架构图、流程图、象限图。

https://github.com/tw93/kami