Home / All Skills / Docs & Knowledge / doc-kami-parchment
Docs & Knowledge · nexu-io/html-anything

doc-kami-parchment

Warm parchment background (#f5f4ed) + ink blue monochromatic accent (#1B365D) + single serif font family, editorial-grade typography.

L1 Basic · Source registration onlyV1 Commit-PinnedDual-pass Audit
Author nexu-ioGitHub nexu-io/html-anything ↗Stars 8827License Apache-2.0(仓库根 LICENSE = Apache License 2.0;GitHub API license.spdx_id = Apache-2.0;next/package.json 亦声明 Apache-2.0)Commit 553ed98c28
Control levels describe skill capabilities and suggested control measures; they do not represent quality or safety certifications, nor do they dictate usability. Usage decisions rest entirely with users and administrators. Different agent hosts apply varying constraints; do not assume hosts provide automatic protection. Third-party skill copyrights belong to their original authors. Use at your own risk.

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.

next/src/lib/templates/loader.ts
routes rescan disk and the client refetches `/api/templates`.
Header comments in the same file define the directory convention: SKILL.md (frontmatter + prompt body) / example.md (optional input example) / example.html (optional preview). This skill directory strictly follows this structure.

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.

next/src/lib/templates/shared.ts
Wrap a per-template instruction body with the shared design directives and
Therefore, the body of this skill is solely responsible for the "layout / style / component library" section; output discipline (single-file HTML, mandatory use of real user data, content-driven quantity) comes from the shared directives, eliminating the need for redundant declarations by template authors.

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).

next/src/lib/templates/shared.ts
**禁止使用 Write / Edit / MultiEdit / Bash / Create / 任何文件系统工具**。不要把 HTML 写到任何 \`.html\` 文件里。前端直接捕获你的 stdout 文本, 文件落盘由前端负责。
This is the architectural source of the skill's zero-disk-write mechanism: the host frontend writes the file, not the skill; there are no scripts within this directory.

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".

next/src/lib/templates/skills/doc-kami-parchment/SKILL.md
- **画布**: 暖羊皮纸 `#f5f4ed` (永远不用纯白 `#fff`)。次级背景 `#efeee5`。
The same section dictates #1f1d18 for primary text, #6b665b for secondary text, and #1B365D ink blue as the sole accent; it forbids drop-shadow, blur, border-radius >= 8px, gradients, neon, and rgba. This transforms "editorial-grade typography" into a mechanically verifiable rule set, leaving the model's creative latitude primarily to content organization.

The monochromatic accent discipline is formulated as a verifiable statement: all accents must use a single ink blue, with multi-color strictly forbidden.

next/src/lib/templates/skills/doc-kami-parchment/SKILL.md
- **唯一色彩**: 墨蓝 `#1B365D` ——所有 accent (链接、tag 描边、重点数字、引用左 rule) 只能用这一个色, 严禁多色。
Example to follow: ink-blue is used exclusively for keywords and tags (`.ink-blue { color: #1B365D; }`), leaving all other hierarchy to font sizes, serifs, and whitespace—embodying the original template's philosophy of "No hard drop shadows / rely on contrast rather than color".

An anti-dashboard orientation is explicitly written into the design guidelines, accompanied by replacement techniques (hairline strokes instead of shadows).

next/src/lib/templates/skills/doc-kami-parchment/SKILL.md
- "Composed pages, not dashboards." 不要堆 KPI 卡, 不要堆 emoji 图标, 不要 hero gradient。
The same section provides positive alternatives: "Ring or whisper only, no hard drop shadows." Shadows must strictly be `0 0 0 1px #d4d1c5` hairlines. This represents a paired "prohibition + alternative" pattern rarely seen in this repository.

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.

next/src/lib/templates/skills/doc-kami-parchment/SKILL.md
- **One-Pager** — 顶 logotype (Charter italic) + 标题 + lede + 3 列要点 + 底脚 metadata。
Within the same section, the Slides type also specifies that "page count is determined by [user content] (starting at 6 pages for brief content, more for comprehensive content)", translating content-driven volume into concrete document types.

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.

next/src/lib/templates/skills/doc-kami-parchment/SKILL.md
- 单文件 HTML, 用 Tailwind CDN; 全文中英混排时加盘古之白; 不要外链图片, 占位用 paper-tint 色块 + 1px ink 描边。
This is the only entry among the 9 templates in this batch to explicitly mandate Tailwind CDN in SKILL.md, and it is the sole source of predictable external links for this skill (see security.reason); example.html indeed references cdn.tailwindcss.com.

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.

next/src/lib/templates/skills/doc-kami-parchment/example.html
<span>KAMI · Open Design</span>
The sample is 4.3KB, with no images or scripts (except for the Tailwind CDN script); example.md is the matching input sample (Open Design Studio Issue №26), demonstrating the workflow of "markdown in -> parchment page out".

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.

next/src/app/api/convert/route.ts
prompt = assemblePrompt({ body: skill.body, content, format });
In the same file, it executes `const skill = loadSkill(templateId);` (returning 400 if the template does not exist) before passing it to invokeAgent; the skill directory itself spawns no processes and performs no networking.

2Core Capabilities

01Rigorous parchment document typography system covering one-pagers, long reports, letters, resumes, equity reports, changelogs, and portfolios
02Monochromatic discipline: sole accent in ink blue #1B365D, with hierarchy established through font size and serif contrast
03Warm parchment canvas #f5f4ed and hairline strokes replacing drop shadows
048 document layouts selected automatically based on content (including a 3-column key points one-pager)
05Bilingual Chinese-English typesetting details: one serif per language, Pangu spacing (CJK-Western spacing), and fallback to Noto Serif SC for Chinese
06Includes matching input examples demonstrating the markdown-to-document workflow

3External Dependencies

KindDependency / Endpoint
networkTailwind CDN(SKILL.md 明令成稿引入;静态样式,不传数据、不需凭证)
networkGoogle Fonts(样例成稿的字体来源;离线回落本地衬线)
packageWeasyPrint(SKILL.md 提及的打印/PDF 渲染器名——决定「用 solid hex 不用 rgba」的设计取舍)

4Recommended Governance & Evidence

Suggested Controls for Safe Operation
For Agent Runtime
Can be auto-loaded
For Administrators
Register source and version
Evidence & Triggers (File Paths & Excerpts)
  • SKILL.md: Pure prompt directives and rule text, without script execution or external side effects.
Audit Notes: Evaluation target = the skill directory itself (SKILL.md + example.html + example.md): zero scripts, zero credential access, zero disk-write directives, and no runtime network invocation code. According to the Batch 4 Final Specification, "artifact references" and "runtime outbound requests" are evaluated separately: the Tailwind CDN cited in the final [Design Guidelines] section of SKILL.md is an **artifact-time reference**—it is embedded into the generated HTML and retrieved by the browser upon viewing, with no outbound network activity during skill execution; furthermore, this endpoint provides only static stylesheets/fonts, transmits no user materials, queries no backend services, consumes no account quota, and reads no credentials, and therefore **does not trigger a rating change** (remains green). Itemized self-verification of endpoints present in the directory: (1) https://cdn.tailwindcss.com (SKILL.md Design Guidelines final item + example.html line 6 <script>); (2) https://fonts.googleapis.com (font links in example.html for Source Serif Pro / Noto Serif SC / IBM Plex Mono); (3) https://github.com/tw93/kami (frontmatter example_source_url, source attribution only, no network call). Host-side context for informational awareness (explanatory only, no rating impact): shared directives mandate CDN linking in the final output, preview iframes use sandbox="allow-scripts allow-same-origin", and the local agent CLI is spawned. Regarding risk factors, there are no orange criteria (no user material sent to external generation/service backends) and no red criteria (no reverse engineering, impersonation, bypasses, or security downgrades).

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

  • Mechanically verifiable style discipline: color values, fonts, line heights, and forbidden items are fully specified, yielding consistent cross-run styling that feels far from arbitrary model aesthetics.
  • Engineered for deep reading over visual display: warm paper background + monochromatic accent + serif hierarchy make continuous reading far more comfortable than a pure white dashboard.
  • Broad document type coverage (8 skeletons), enabling a single template to produce one-pagers, long reports, letters, resumes, equity reports, and changelogs.
  • Print-oriented: explicitly tailored to WeasyPrint rendering capabilities (solid hex instead of rgba), making print and PDF export highly predictable.
  • Traceable provenance: attribution to tw93/kami is documented in both frontmatter and README, establishing it as an open-source derivative work rather than plagiarism.
  • Best for: Ideal for serious long-form and formal documents: white paper or research report one-pagers, investment memos, formal correspondence, resumes, changelogs, and financial summary reports; suitable for scenarios requiring print or PDF distribution that demand a paper-like feel rather than a web UI aesthetic; perfect for teams with restrained branding seeking a unified document template.
    Not for: Not suitable for dashboards or KPI card walls, marketing landing pages, or product pages requiring multi-color schemes and illustrations (which violate forbidden constraints); not suitable for interactive or animated scenarios (scripts and shadows are forbidden); not suitable for financial visualizations requiring multi-colored charts (only monochrome SVG sparklines are allowed); and not suitable for quick drafting scenarios, as the sheer volume of rules leads to higher generation overhead.
    Install Agent-Ready
    ① Verified Mirror 2026-09-15
    Option A · Direct DownloadDownload doc-kami-parchment.tar.gz
    sha256: 8d42d07c1757e428…
    Option B · Copy Guide for Agent
    install.json
    Agents automatically download and verify mirrors from this JSON guide.
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit 553ed98c28.