Kami: templates and layout rules for agent-rendered documents
👩🚒 Good content deserves good paper.
At a glance
- What is it?
- Kami is a skill package, not an application. It hands an AI agent eight document templates, a landing-page system and layout rules, then renders the result to PDF, PNG or editable PowerPoint. English and Chinese are the tuned paths, and the font dependencies decide what a given machine can actually produce.
- Who is it for?
- Kami fits a writer or engineer who wants an agent to hand back a typeset PDF, PNG or editable deck instead of raw Markdown, and who works in English or Chinese. It does not fit a team that needs a document editor with tracked changes, or a Japanese workflow that needs translated templates rather than font fallbacks.
- Can I use it commercially?
- Yes. MIT is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
- Is it still maintained?
- Yes. The repository last received commits 5 days ago.
- What is it written in?
- Mainly HTML, according to GitHub's language statistics.
Answers come from the project's GitHub data, last synced on November 15, 2026, and from our analysis. They are not legal advice.
Star history
- tw93/Kami12,553 ★ · +809
| Repository | 2026-09-22 | 2026-11-15 |
|---|---|---|
| tw93/Kami | 11.7k | 12.6k |
809 Stars in the last 54 days, measured from the daily GitHub snapshot. Compare with other projects
Editorial analysis
Eight templates and a landing page, not a document editor
Kami has no interface of its own. It is a skill package that hands an AI agent a set of templates and layout rules, and the agent fills them in and renders the result. The output targets are PDFs and PNGs, with slides also exportable as editable PowerPoint files. Eight document templates come with it: One-Pager, Long Doc, Letter, Portfolio, Resume, Slides, Equity Report and Changelog, plus a landing-page system.
Nothing in that list is interchangeable. Templates separate a title, body text and notes by type size and spacing, and the defaults are a warm parchment background at `#f5f4ed` with ink-blue accents at `#1B365D` and serif fonts. All of it is adjustable, but a request that says nothing about styling gets that look.
The name means paper in Japanese, 紙. The author frames it as the third of a trilogy, with Kaku writing code and Waza drilling habits, and Kami delivering the finished document. The showcase in the README shows the intended range: a two-page founder resume, a Tesla Q1 2026 equity report in Chinese, a one-page product brief, a recommendation letter, release notes, and a seven-page terminal portfolio.
One npx command puts a single copy in ~/.agents/skills
The shared-directory route is one command:
npx skills add tw93/kami -a claude-code codex cursor -g -yWhat lands is one copy in `~/.agents/skills`. Claude Code is symlinked into it, and Codex, Cursor and every other agent that reads that directory picks Kami up as `/kami`. There is no second copy per tool, which is what makes the update a single command as well:
npx skills update -g -yFirst use needs no slash command either. The skill triggers from an ordinary request, and these are the English examples given:
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 appEquivalent lists exist in Chinese, Japanese and Korean. What you should look for after the first request is a file rather than a chat reply, because a skill that does not trigger answers in the conversation and looks like a plain model response.
Three install routes and three different update commands
A second route installs Kami as a host plugin, and it carries both a version floor and a different name:
# 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@kamiThat path needs Claude Code v2.1.142 or newer, and the skill is namespaced as `/kami:kami` instead of `/kami`, so an invocation written for one install will not resolve the same way under the other. Codex needs two commands to update rather than one, because the marketplace and the plugin are separate objects there.
Claude Desktop has no command line at all. You download the release asset `kami.zip`, not GitHub's source ZIP, open Customize, then Skills, then the plus button, then Create skill, and upload it. An update means clicking the three-dot menu on the skill card, choosing Replace, and uploading the newest archive.
ensure-fonts.sh reaches for jsDelivr, so CJK rendering wants a network
No package ships the large CJK fonts. `skills/kami/scripts/ensure-fonts.sh` recovers missing Chinese or Korean fonts into the user font directory at run time, and in a repository checkout it also copies the tracked fonts into the skill so templates load them locally. Only after that does it fall back to the jsDelivr CDN.
The consequence is that the first Chinese or Korean render is not self-contained. On a machine that has none of the fonts and no outbound network, the fonts cannot be fetched.
A second network behaviour is worth knowing about. Kami runs a version check at most once a day, writes a marker in the local XDG cache directory, then resolves GitHub's latest public release. It uploads no document or task content and fails silently when offline or when no cache home is available, so an air-gapped machine loses only the new-release notice.
Japanese and Korean run on font fallbacks, not translated templates
English and Chinese are the tuned paths. Japanese and Korean are supported through language-specific font fallbacks and layout adjustments, and the README says each output is checked before delivery.
The template inventory is where the cost may show. The README enumerates the eight templates and the landing-page system in EN, CN and KO, while Japanese has a full row of example prompts and a showcase portfolio but is not listed in that inventory. The language table gives Japanese YuMincho (游明朝) as its default serif font and Korean Source Han Serif K (본명조), both marked as font fallbacks and layout check, against Complete for English and Chinese. For a reader the practical move is to render one complete sample in the target language and read it, because a per-file check is a weaker promise than a translated template.
Mermaid diagrams need a renderer Kami does not ship
Eighteen inline SVG types live inside the skill, including what the README calls a report-scale architecture board. The README also says sequence, class and ER diagrams can be authored from Mermaid.
Three slide renderers, and Pygments decides between colour and grey
Kami's output is PDF, PNG or editable PowerPoint, and the English example prompts include a request for a Marp deck. The README also notes that on Windows you should run Kami inside WSL (Ubuntu), because the helper scripts are Bash and WeasyPrint on native Windows needs the GTK/Pango runtime installed separately.
Content schemas catch missing sections, and brand.md cannot override an explicit instruction
Kami reads an optional profile at `~/.config/kami/brand.md`. Its YAML frontmatter carries name, role, email, brand color, language, page size and tone, with a Markdown body for freeform notes, and Kami applies those settings wherever the current request leaves a choice open. Explicit instructions always win. The file is a default rather than an override, so a one-off request that contradicts your profile still gets what you asked for, and a colleague rendering on a machine with no profile file will not match your output.
Editorial conclusion
Kami fits a writer or engineer who wants an agent to hand back a typeset PDF, PNG or editable deck instead of raw Markdown, and who works in English or Chinese. It does not fit a team that needs a document editor with tracked changes, or a Japanese workflow that needs translated templates rather than font fallbacks. Before adopting, render one full document on the machine that will actually run it and check whether ensure-fonts.sh found the CJK fonts, because large CJK fonts are not bundled in any package.
Frequently asked questions
What file formats can Kami produce?
Kami produces PDFs and PNGs, and it can export slides as editable PowerPoint files. Those come from eight document templates, One-Pager, Long Doc, Letter, Portfolio, Resume, Slides, Equity Report and Changelog, plus a landing-page system.
How do I install Kami for Claude Code and Codex?
Run npx skills add tw93/kami -a claude-code codex cursor -g -y, which places one copy in ~/.agents/skills, symlinked for Claude Code and read by Codex, Cursor and other agents from that same directory as /kami. Updating that install is npx skills update -g -y. A plugin route also exists and needs Claude Code v2.1.142 or newer.
Does Kami need to be online to render a document?
The large Chinese and Korean fonts are not bundled, so skills/kami/scripts/ensure-fonts.sh recovers missing ones into the user font directory and otherwise falls back to the jsDelivr CDN. The separate version check resolves GitHub's latest public release at most once a day and fails silently when offline or when no cache home is available.
Can I keep my brand colours and page size across documents?
Create ~/.config/kami/brand.md with YAML frontmatter for name, role, email, brand color, language, page size and tone, plus a Markdown body for freeform notes. Kami applies those settings where a request leaves a choice open, and explicit instructions in the request take priority over them.
Official sources
Add this badge to your README
If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.
[](https://hysenlabs.com/projects/tw93-kami)Star history chart for your README
[](https://hysenlabs.com/projects/tw93-kami)Was this useful?