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
:root via
the language parameter.
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
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 in
design-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
1---
2name: kami-deck
3en_name: "Turn a Study into a Lab Meeting Deck like a Senior Postdoc"
4zh_name: "像资深博士后一样做组会研究汇报"
5description: |
6 A lab-meeting deck on gut-microbiome links to sleep quality — the design, the results, the caveats, and the next experiment. Built as a decision-grade academic research deck for lab group, PI.
7en_description: |
8 A lab-meeting deck on gut-microbiome links to sleep quality — the design, the results, the caveats, and the next experiment. Built as a decision-grade academic research deck for lab group, PI.
9zh_description: |
10 像资深博士后一样做组会研究汇报——一份可商业交付的学术研究 Deck,围绕真实主题、证据链与决策目标组织。
11tags:
12 - "academic-research"
13 - "academic-review-deck"
14 - "research"
15 - "grant"
16 - "review"
17 - "decision-deck"
18 - "commercial-slide-agent"
19 - "kami-deck"
20triggers:
21 - "academic-review-deck"
22 - "academic-research"
23 - "Turn a Study into a Lab Meeting Deck like a Senior Postdoc"
24 - "像资深博士后一样做组会研究汇报"
25 - "research"
26 - "grant"
27 - "review"
28 - "html deck"
29 - "html slides"
30od:
31 surface: web
32 mode: deck
33 audience: founders, researchers, design studios, conference talks
34 tone: editorial, restrained, print-first
35 scale: 6-15 viewport-locked slides
36 preview:
37 type: html
38 entry: index.html
39 design_system:
40 requires: false
41 craft:
42 requires:
43 - typographic-rhythm
44 - pixel-discipline
45 category: "academic-research"
46 scenario: "research"
47 example_prompt: "Create \"Turn a Study into a Lab Meeting Deck like a Senior Postdoc\" as a decision-grade Academic research deck in this template's own visual system. Subject: A lab-meeting deck on gut-microbiome links to sleep quality — the design, the results, the caveats, and the next experiment. Audience: lab group, PI. First ask only for missing essentials: audience, decision target, source-of-truth materials, deadline, and must-keep numbers. Then produce the slide plan, written slides, visual direction, speaker-ready structure, and a critic pass against this rubric: does the deck prove novelty without overclaiming."
48inputs:
49 - id: brand
50 label: Brand identity (shared across slides)
51 - id: deck_title
52 label: Deck title shown in the per-slide chrome
53 - id: slides
54 label: Ordered list of typed slides (cover · chapter · content · stats · quote · cta · end)
55 - id: language
56 label: Primary language stack
57parameters:
58 language:
59 type: enum
60 values: [en, zh-CN, ja]
61 default: en
62 description: Sets `--serif` to Charter / TsangerJinKai02 / YuMincho respectively.
63outputs:
64 - path: <out>/index.html
65 description: Self-contained kami deck with horizontal swipe pagination.
66capabilities_required:
67 - file-write
68example_prompt: |
69 Build me a 9-slide kami-style internal deck for "Hokuto Research" —
70 a Q1 portfolio review. Cover slide on ink-blue with the firm name.
71 Chapter dividers between Macro, Equities, and Outlook. Three content
72 slides with ink-blue numbered headings. One stats slide showing
73 AUM / IRR / fund count. One closing CTA. End card with the firm
74 signature. Japanese language stack.
75metadata:
76 source: https://skillmd.com/skills/nexu-io/kami-deck
77---
78
79# kami-deck
80
81Sister skill to [`kami-landing`](../kami-landing/). Produces a single
82self-contained HTML file: a horizontal magazine-style swipe deck in
83the **kami (紙 / 纸)** design system — print rhythm, ink-blue accent,
84serif at one weight, no italic, no cool grays.
85
86The navigation model is intentionally borrowed from the
87[`guizang-ppt`](../guizang-ppt/) skill — `←/→` arrow keys, wheel /
88swipe, ESC for the overview grid. The aesthetic stays kami: parchment
89content slides, ink-blue cover and chapter slides, serif everywhere.
90
91> **Design system source of truth:**
92> [`design-systems/kami/DESIGN.md`](../../design-systems/kami/DESIGN.md).
93> Read it before shipping. Tokens, type rules, and forbidden colors
94> all live there. Slide-specific scale ratios (macro × 1.6,
95> letter-spacing × 0.6 vs. print) are documented in §3 "Hierarchy"
96> and §5 "Layout Principles · Slides".
97
98## What you get
99
100- N viewport-sized slides (6-15 is the sweet spot) laid out
101 horizontally on one transformed flex track.
102- **Cover and chapter slides** flip background to ink-blue
103 (`#1B365D`) with ivory text — the only place dark theme is used.
104- **Content / stats / quote / CTA slides** stay on parchment
105 (`#f5f4ed`) with serif at weight 500.
106- **Per-slide chrome strip**: brand mark · deck title · live slide
107 counter (`01 / 09`).
108- **Tabular-nums** on every counter, metric, page number.
109- **Coral-free** — kami's accent is ink-blue. Progress bar and dot
110 nav are ink-blue too.
111- **Keyboard / wheel / touch nav**, ESC overview grid, dot indicator.
112- **Multilingual stack** — EN / zh-CN / ja, set on `:root` via
113 the `language` parameter.
114
115## Slide types
116
117| Kind | Background | Use it for |
118| :---------- | :--------- | :-------------------------------------------------------- |
119| `cover` | ink-blue | Title plate at the start. Centered serif title + tagline. |
120| `chapter` | ink-blue | Roman/Arabic numeral chapter divider. |
121| `content` | parchment | Section number + title + body + optional bullets. |
122| `stats` | parchment | 3-4 metric cells (value · label · sub). |
123| `quote` | parchment | Pull quote with ink-blue left rule + author signature. |
124| `cta` | parchment | Closing pitch + 1-2 buttons. |
125| `end` | ink-blue | Mega serif kicker word + colophon footer. |
126
127A typical 11-slide deck:
128
129```
1301. cover — ink-blue title plate
1312. chapter — "01 / Why now"
1323. content — manifesto
1334. content — capabilities + bullets
1345. stats — 4 numbers
1356. chapter — "02 / How it feels"
1367. content — method
1378. content — selected work
1389. quote — testimonial
13910. cta — primary action
14011. end — ink-blue kicker
141```
142
143## Workflow
144
145### 1. Gather the brief
146
147Ask in two rounds (don't dump the whole list at once):
148
1491. Identity round — name, mark, tagline, location, edition, language.
1502. Content round — for each slide, kind + the typed fields.
151
152### 2. Pick the language stack
153
154Same as [`kami-landing`](../kami-landing/SKILL.md#2-pick-the-language-stack):
155EN → Charter, zh-CN → TsangerJinKai02 / Source Han Serif, ja →
156YuMincho. JA also overrides `--olive` to `#4d4c48` because YuMincho
157strokes are thinner.
158
159### 3. Write `index.html`
160
161Output a single file with all CSS inline. Mirror the structure of
162[`example.html`](./example.html). Use only the tokens from
163`design-systems/kami/DESIGN.md`.
164
165The runtime script (keyboard / wheel / touch nav, dot indicator,
166progress bar, ESC overview) should match the model documented in
167[`open-design-landing-deck/scripts/compose.ts`](../open-design-landing-deck/scripts/compose.ts).
168Do **not** reuse the open-design-landing-deck CSS; the visual
169language is different.
170
171### 4. Self-check
172
173- [ ] All cover / chapter / end slides use ink-blue background
174 (`#1B365D`) with ivory text. All other slides are on
175 parchment.
176- [ ] Ink-blue covers ≤ 5% of any parchment slide's surface.
177- [ ] Slide titles use serif weight 500 only. No italic.
178- [ ] All numeric stacks (counter, metrics, page numbers) carry
179 `font-variant-numeric: tabular-nums`.
180- [ ] Press `→` / `Space` / scroll. Smoothly slides one viewport
181 to the right; dot nav advances; the ink-blue progress bar
182 ticks forward.
183- [ ] Press `Esc`. Overview grid appears with scaled thumbnails.
184- [ ] Resize to 1080px and 640px. Cover / content collapse to a
185 single column; dot nav still works.
186- [ ] Lighthouse: contrast AA, font-display swap, no layout shift.
187
188## Boundaries
189
190- **Do not** introduce a second accent color. Pick ink-blue or
191 pick nothing.
192- **Do not** use italic anywhere — emphasis swaps to ink-blue.
193- **Do not** use `rgba()` for tag fills; pre-blend over parchment
194 and use solid hex from the table in
195 `design-systems/kami/DESIGN.md` §2.
196- **Do not** add a router. This is a single-file artifact.
197- **Do not** reuse Atelier Zero collage imagery (the open-design-landing
198 visual system). Kami is gradient-free, image-light, and hierarchy
199 is carried by type.
200
201## See also
202
203- [`kami-landing`](../kami-landing/) — long-form one-pager sister skill.
204- [`design-systems/kami/DESIGN.md`](../../design-systems/kami/DESIGN.md) — token spec.
205- [`open-design-landing-deck`](../open-design-landing-deck/) — same
206 horizontal swipe nav model, different visual language (Atelier Zero).
207- Upstream: [`tw93/kami`](https://github.com/tw93/kami) — original
208 Claude skill (MIT). Kami's slides.py template documents the macro
209 × 1.6 / micro × 0.6 ratios this skill applies.