doc-kami-parchment
Warm parchment background (#f5f4ed) + ink blue monochromatic accent (#1B365D) + single serif font family, editorial-grade typography.
1How It Works & Mechanism
This skill is not an executable program, but adheres to "one directory = one template": frontmatter in SKILL.md is used for selector display, while the body serves as the prompt sent to the model; adding a template equals adding a directory, without modifying TypeScript.
routes rescan disk and the client refetches `/api/templates`.
The actual dispatched prompt = shared platform design directives (SHARED_DESIGN_DIRECTIVES) + the body of this skill's SKILL.md + user content, assembled into a single prompt via assemblePrompt.
Wrap a per-template instruction body with the shared design directives and
The final output bypasses the filesystem: shared directives strictly prohibit file tools such as Write, Edit, or Bash, requiring the model to stream the entire HTML directly as the response body (stdout is captured and written to disk by the frontend).
**禁止使用 Write / Edit / MultiEdit / Bash / Create / 任何文件系统工具**。不要把 HTML 写到任何 \`.html\` 文件里。前端直接捕获你的 stdout 文本, 文件落盘由前端负责。
This is the most strictly constrained template in the batch: SKILL.md nails down the canvas, ink color, sole accent color, typography, line height, and forbidden items in a section titled "Rigid Visual Signature — Do Not Alter".
- **画布**: 暖羊皮纸 `#f5f4ed` (永远不用纯白 `#fff`)。次级背景 `#efeee5`。
The monochromatic accent discipline is formulated as a verifiable statement: all accents must use a single ink blue, with multi-color strictly forbidden.
- **唯一色彩**: 墨蓝 `#1B365D` ——所有 accent (链接、tag 描边、重点数字、引用左 rule) 只能用这一个色, 严禁多色。
An anti-dashboard orientation is explicitly written into the design guidelines, accompanied by replacement techniques (hairline strokes instead of shadows).
- "Composed pages, not dashboards." 不要堆 KPI 卡, 不要堆 emoji 图标, 不要 hero gradient。
Provides 8 optional layout skeletons based on document type (One-Pager / Long Doc / Letter / Portfolio / Resume / Slides / Equity Report / Changelog), dynamically selected based on user content rather than a fixed page format.
- **One-Pager** — 顶 logotype (Charter italic) + 标题 + lede + 3 列要点 + 底脚 metadata。
Technical constraints for the final output are reaffirmed in this template: single-file HTML, Tailwind CDN usage, no external linked images, and placeholders using color blocks with 1px ink strokes.
- 单文件 HTML, 用 Tailwind CDN; 全文中英混排时加盘古之白; 不要外链图片, 占位用 paper-tint 色块 + 1px ink 描边。
The sample output itself is a one-pager designed to feel like typeset physical paper: folio top bar + kicker + large heading + 3-column pillars + footer, constructed entirely with Tailwind classes and 4 color values.
<span>KAMI · Open Design</span>
The server-side /api/convert performs only three tasks: reads the skill from disk by templateId, assembles the prompt, spawns the local agent CLI, and relays the output via SSE stream.
prompt = assemblePrompt({ body: skill.body, content, format });
2Core Capabilities
3External Dependencies
| Kind | Dependency / Endpoint |
|---|---|
| network | Tailwind CDN(SKILL.md 明令成稿引入;静态样式,不传数据、不需凭证) |
| network | Google Fonts(样例成稿的字体来源;离线回落本地衬线) |
| package | WeasyPrint(SKILL.md 提及的打印/PDF 渲染器名——决定「用 solid hex 不用 rgba」的设计取舍) |
4Recommended Governance & Evidence
- SKILL.md: Pure prompt directives and rule text, without script execution or external side effects.
5Second-Pass Verification
- [ok] 「暖羊皮纸 #f5f4ed(永远不用纯白 #fff)」 — 样例 body background: #f5f4ed;全文无 #fff 背景(tag 用 #efeee5)。
- [ok] 「唯一色彩墨蓝 #1B365D,严禁多色」 — 样例彩色只有 #1B365D(.ink-blue 与 tag 文字),其余为纸色/墨色/中性灰。
- [discrepancy] 「一种语言一种衬线(Charter / Source Serif Pro / Noto Serif SC)」 — SKILL.md 首选英文衬线是 Charter(fallback: Source Serif Pro),样例直接用 fallback 族名 'Source Serif Pro' 作主字体——符合「允许 fallback」的字面,但成稿与首选有差;且未加载 Charter。
- [discrepancy] 「绝不:drop-shadow / 圆角 ≥ 8px / 渐变 / rgba」 — 样例未用 drop-shadow/渐变/圆角,但正文段落用 style="color:#3a382f" 引入了 SKILL.md 墨色清单外的第四种文字色(清单只给 #1f1d18 主文与 #6b665b 次文);属轻微越界,不影响单色 accent 纪律。
- [ok] 成稿运行时外链(Tailwind CDN) — SKILL.md 明写「用 Tailwind CDN」,example.html 确有 <script src="https://cdn.tailwindcss.com"></script>;已在 external_deps 与 security.reason 逐条自证。
- [ok] 带 example.md 输入样例 — example.md 为 Open Design Studio Issue №26 的 markdown,与 example.html 内容一一对应(Berlin 坐标、Apache 2.0、四支柱)。
- [ok] 出处标注真实(非虚构来源) — frontmatter example_source_url = https://github.com/tw93/kami;README 第 490 行「模板来源」表同样映射 doc-kami-parchment ← tw93/kami,两处一致。
6Verdict & Scenarios
8d42d07c1757e428…