kami-deck
Produce a print-grade slide deck in the kami (紙 / 纸) design system — warm parchment background (or ink-blue for cover / chapter slides), serif at one weight, ink-blue accent ≤ 5% per slide, no italic. Horizontal magazine swipe pagination (←/→ · wheel · swipe · ESC overview). One self-contained HTML file, zero dependencies beyond Google Fonts.
- License 许可
- Apache-2.0
- 所属仓库
- zai-org/ZCode
- 最近更新
- 2026-11-13
- Stars
- ★ 8.7k
- Forks
- 2.7k
01 前言 Front Matter
- od
- { "mode": "deck", "tone": "editorial, restrained, print-first", "craft": { "requires": [ "typographic-rhythm", "pixel-discipline" ] }, "scale": "6-15 viewport-locked slides", "preview": { "type": "html", "entry": "index.html" }, "surface": "web", "audience": "founders, researchers, design studios, conference talks", "category": "brand-deck", "featured": 4, "scenario": "marketing", "design_system": { "requires": false } }
- name
- kami-deck
- inputs
- [ { "id": "brand", "label": "Brand identity (shared across slides)" }, { "id": "deck_title", "label": "Deck title shown in the per-slide chrome" }, { "id": "slides", "label": "Ordered list of typed slides (cover · chapter · content · stats · quote · cta · end)" }, { "id": "language", "label": "Primary language stack" } ]
- outputs
- [ { "path": "<out>/index.html", "description": "Self-contained kami deck with horizontal swipe pagination." } ]
- triggers
- [ "kami deck", "紙 deck", "纸 deck", "paper slides", "white paper deck", "editorial deck", "print-style slides", "kami slides" ]
- parameters
- { "language": { "type": "enum", "values": [ "en", "zh-CN", "ja" ], "default": "en", "description": "Sets `--serif` to Charter / TsangerJinKai02 / YuMincho respectively." } }
- description
- Produce a print-grade slide deck in the kami (紙 / 纸) design system — warm parchment background (or ink-blue for cover / chapter slides), serif at one weight, ink-blue accent ≤ 5% per slide, no italic. Horizontal magazine swipe pagination (←/→ · wheel · swipe · ESC overview). One self-contained HTML file, zero dependencies beyond Google Fonts.
- example_prompt
- Build me a 9-slide kami-style internal deck for "Hokuto Research" — a Q1 portfolio review. Cover slide on ink-blue with the firm name. Chapter dividers between Macro, Equities, and Outlook. Three content slides with ink-blue numbered headings. One stats slide showing AUM / IRR / fund count. One closing CTA. End card with the firm signature. Japanese language stack.
- capabilities_required
- [ "file-write" ]
02 资源文件 2
- 参考文档example.html32.3 KB
- 参考文档README.md2.6 KB
03 SKILL.md 正文
kami-deck
Sister skill to kami-landing. Produces a single
self-contained HTML file: a horizontal magazine-style swipe deck in
the kami (紙 / 纸) design system — print rhythm, ink-blue accent,
serif at one weight, no italic, no cool grays.
The navigation model is intentionally borrowed from the
guizang-ppt skill — ←/→ arrow keys, wheel /
swipe, ESC for the overview grid. The aesthetic stays kami: parchment
content slides, ink-blue cover and chapter slides, serif everywhere.
Design system source of truth:
design-systems/kami/DESIGN.md. Read it before shipping. Tokens, type rules, and forbidden colors all live there. Slide-specific scale ratios (macro × 1.6, letter-spacing × 0.6 vs. print) are documented in §3 "Hierarchy" and §5 "Layout Principles · Slides".
What you get
- N viewport-sized slides (6-15 is the sweet spot) laid out horizontally on one transformed flex track.
- Cover and chapter slides flip background to ink-blue
(
#1B365D) with ivory text — the only place dark theme is used. - Content / stats / quote / CTA slides stay on parchment
(
#f5f4ed) with serif at weight 500. - Per-slide chrome strip: brand mark · deck title · live slide
counter (
01 / 09). - Tabular-nums on every counter, metric, page number.
- Coral-free — kami's accent is ink-blue. Progress bar and dot nav are ink-blue too.
- Keyboard / wheel / touch nav, ESC overview grid, dot indicator.
- Multilingual stack — EN / zh-CN / ja, set on
:rootvia thelanguageparameter.
Slide types
| Kind | Background | Use it for |
|---|---|---|
cover |
ink-blue | Title plate at the start. Centered serif title + tagline. |
chapter |
ink-blue | Roman/Arabic numeral chapter divider. |
content |
parchment | Section number + title + body + optional bullets. |
stats |
parchment | 3-4 metric cells (value · label · sub). |
quote |
parchment | Pull quote with ink-blue left rule + author signature. |
cta |
parchment | Closing pitch + 1-2 buttons. |
end |
ink-blue | Mega serif kicker word + colophon footer. |
A typical 11-slide deck:
1. cover — ink-blue title plate
2. chapter — "01 / Why now"
3. content — manifesto
4. content — capabilities + bullets
5. stats — 4 numbers
6. chapter — "02 / How it feels"
7. content — method
8. content — selected work
9. quote — testimonial
10. cta — primary action
11. end — ink-blue kicker
Workflow
1. Gather the brief
Ask in two rounds (don't dump the whole list at once):
- Identity round — name, mark, tagline, location, edition, language.
- Content round — for each slide, kind + the typed fields.
2. Pick the language stack
Same as kami-landing:
EN → Charter, zh-CN → TsangerJinKai02 / Source Han Serif, ja →
YuMincho. JA also overrides --olive to #4d4c48 because YuMincho
strokes are thinner.
3. Write index.html
Output a single file with all CSS inline. Mirror the structure of
example.html. Use only the tokens from
design-systems/kami/DESIGN.md.
The runtime script (keyboard / wheel / touch nav, dot indicator,
progress bar, ESC overview) should match the model documented in
open-design-landing-deck/scripts/compose.ts.
Do not reuse the open-design-landing-deck CSS; the visual
language is different.
4. Self-check
- [ ] All cover / chapter / end slides use ink-blue background
(
#1B365D) with ivory text. All other slides are on parchment. - [ ] Ink-blue covers ≤ 5% of any parchment slide's surface.
- [ ] Slide titles use serif weight 500 only. No italic.
- [ ] All numeric stacks (counter, metrics, page numbers) carry
font-variant-numeric: tabular-nums. - [ ] Press
→/Space/ scroll. Smoothly slides one viewport to the right; dot nav advances; the ink-blue progress bar ticks forward. - [ ] Press
Esc. Overview grid appears with scaled thumbnails. - [ ] Resize to 1080px and 640px. Cover / content collapse to a single column; dot nav still works.
- [ ] Lighthouse: contrast AA, font-display swap, no layout shift.
Boundaries
- Do not introduce a second accent color. Pick ink-blue or pick nothing.
- Do not use italic anywhere — emphasis swaps to ink-blue.
- Do not use
rgba()for tag fills; pre-blend over parchment and use solid hex from the table indesign-systems/kami/DESIGN.md§2. - Do not add a router. This is a single-file artifact.
- Do not reuse Atelier Zero collage imagery (the open-design-landing visual system). Kami is gradient-free, image-light, and hierarchy is carried by type.
See also
kami-landing— long-form one-pager sister skill.design-systems/kami/DESIGN.md— token spec.open-design-landing-deck— same horizontal swipe nav model, different visual language (Atelier Zero).- Upstream:
tw93/kami— original Claude skill (MIT). Kami's slides.py template documents the macro × 1.6 / micro × 0.6 ratios this skill applies.
04 同仓库更多 Skills
plugin-mcp-ping
E2E workspace Plugin skill marker
e2e-ext-compat-plain
PLM-EXT-STORE fixture skill for e2e-ext-compat-plain.
e2e-ext-compat-ok
PLM-EXT-STORE fixture skill for e2e-ext-compat-ok.
e2e-ext-compat-installed
PLM-EXT-STORE fixture skill for e2e-ext-compat-installed.
e2e-ext-compat-future
PLM-EXT-STORE fixture skill for e2e-ext-compat-future.
e2e-store-skill-b
E2E store fixture skill b