--- a/.claude/skills/zenbu-personal-site/SKILL.md	Tue Aug 04 15:12:18 2026 -0700
+++ b/.claude/skills/zenbu-personal-site/SKILL.md	Tue Aug 04 16:49:01 2026 -0700
@@ -13,6 +13,9 @@
 - `mrjunejune/src/`: static site source files and HTML templates.
 - `mrjunejune/src/parts/`: shared HTML includes used by `{{...}}` template placeholders.
 - `mrjunejune/src/public/`: public assets, PWA files, media, generated JS, icons, resume PDF.
+- Zenbu UI assets are copied from `//design_system:components` and
+  `//design_system:styles` into `src/public/design-system/` by Bazel. Do not
+  hand-copy or fork shared component files.
 - `mrjunejune/test/`: integration tests and snapshots.
 - `mrjunejune/BUILD`: Bazel build, bundle, asset movement, and test-visible filegroups.
 - `mrjunejune/.config` and `.config.development`: server configuration. Do not commit secrets.
@@ -68,4 +71,7 @@
 - For binary responses, set `content-length` and avoid string-only operations on body bytes.
 - If a route is part of the public website, add or update snapshot coverage in `mrjunejune/test`.
 - Keep PWA changes consistent across `manifest.json`, `sw.js`, icons, and `PWA_SETUP.md`.
+- Site themes use `data-zen-theme` with Auto, Paper, Ink, and Playful states.
+  Preserve the More Sugar font aliases and keep theme-specific values in shared
+  design-system tokens rather than branching inside components.
 - Reuse `seobeo`, `dowa`, `deita`, `s3`, and `markdown_converter` instead of adding parallel implementations.