Kami · Paper
One typesetting system for professional documents and landing pages: warm parchment, ink-blue accent, serif-led hierarchy — resumes, one-pagers, white papers, slides, and product pages.
Evidence shows significant effort toward least privilege and data-flow transparency: SKILL.md explicitly states the update check is read-only, at most once per day, fails silently; MCP server docs emphasize rendering only trusted local HTML; materials check requires user-provided assets, presenting gaps as a table rather than guessing; brand profile fills gaps silently. No red-line risks such as credential theft, exfiltration, or destructive defaults found. Deductions: the skill actively runs an external script (check-update.sh), although declared no data sent, unverifiable statically; MCP server allows rendering local HTML but does not explicitly restrict file access scope; dependencies on external fonts (e.g., TsangerJinKai02) from CDN involve network requests; no explicit rollback or undo procedure; publisher identity unverified, but only used as maintenance attribution, not a deduction by itself. Score 15: main risks visible but permissions, confirmation, rollback incomplete.
Static review observes high self-consistency in instructions: SKILL.md provides clear steps, template selection tables, verification commands (e.g., build.py --check-*), AGENTS.md documents known traps and CI gotchas, showing engineering rigor. But nothing executed, so key paths (e.g., render.py, build.py --verify) unconfirmed. Dependencies like WeasyPrint, Pygments, Marp CLI are optional, but no full fallback mechanism for installation failure (except font recovery script). Error handling: SKILL.md says external command failures should silently continue, but no clear, diagnostic error message templates. Static limit allows max 10: happy path plausible but tests, edge cases, error handling thin.
Use cases clear: eight document types and landing pages, audience and scenarios clear. SKILL.md provides detailed trigger terms in Chinese, English, Japanese, enabling precise triggering, avoiding false triggers. Environment fit: explicit support for Chinese, English, Japanese, Korean, with CJK font fallbacks; but font dependency on commercial TsangerJinKai02 and system fonts may affect Chinese rendering if user cannot install, and no mainland-network optimization (e.g., CDN accessibility) addressed. Capability boundaries well-declared: no hosted service, not a theme engine, progressive disclosure. Deductions: non-fit scenarios (e.g., simple plain-text formatting) not explicitly listed, may cause over-triggering; environment fit for mainland network with external CDN font downloads not risk-assessed. Score 13: clear scenario but some boundary/environment evidence thin.
Good information architecture: SKILL.md provides progressive disclosure, loading needed specs per document type; install/dependency notes detailed in README (plugin install, ZIP download); parameter and naming stability with script consistency checks; examples (assets/demos) and FAQ-like notes present. License explicit MIT, but no version or changelog in supplied files (VERSION exists but not shown); maintenance responsibility clear (one maintainer, contact in contact.md), but update path (e.g., PR workflow) not fully explicit. Deductions: version/changelog missing in provided files, likely in docs/release.md but not statically verified; known limitations like commercial font usage not emphasized in SKILL.md. Score 12: readable and usable but hidden assumptions or incomplete governance.
Static review cannot verify actual outputs, but SKILL.md describes output formats (HTML, PDF, PPTX) and verification commands with high plausibility. Value proposition clear: constraint system reduces inconsistency, claimed more efficient than manual or alternatives. But no actual generated documents (e.g., assets/demos PDFs) in reviewed material, so direct usability unconfirmed. Static limit allows max 7: completes core task but output completeness, direct usability, comparative-benefit evidence limited. Deduction: no execution evidence to confirm task completion.
SKILL.md and AGENTS.md reference CI workflows (.github/workflows/check.yml and release.yml) and test suite (scripts/tests/test_build.py), but these files not included in provided material, so cannot verify their existence or content. Provides reproducible verification commands (e.g., build.py --check), but no third-party execution evidence (e.g., CI logs). Thus, key claims (e.g., CI existence) lack cross-corroboration. Static limit allows max 5: auditable primary material or limited reproduction but thin coverage. Deduction: no third-party evidence, tests/CI not shown in files.
- The skill may invoke an update-check script at runtime; declared read-only and no data sent, but be aware of network calls.
- PDF rendering depends on optional dependencies like WeasyPrint; if missing, rendering may fail with install hints only, not full diagnostics.
- Chinese fonts rely on commercial TsangerJinKai02 (free for personal use); obtain a license for commercial use.
- Core functionality may use CDN font downloads that could be unreachable from mainland China, affecting PDF rendering quality.
- No explicit rollback or undo procedure is provided; users should back up before modifications.
What does this skill do, and when should you use it?
Kami is a document typesetting constraint system for AI agents, solving style drift and bland layouts in AI-generated output. It ships eight document templates (one-pager, long doc, letter, portfolio, resume, slides, equity report, changelog) plus a landing-page system, each in EN, CN, and KO. The design uses a warm parchment canvas, a single ink-blue accent, and serif-led hierarchy with a tight editorial rhythm. Beyond templates, it includes content extraction, validation gates (placeholders, density, fonts, visual), inline SVG diagrams, and briefs for AI image generation.
Kami auto-detects document type and language from natural requests, picks the right HTML template, and fills it with distilled content. It runs Python scripts to build PDFs (WeasyPrint by default) or PPTX on request, and verifies output via commands like --check-placeholders, --check-content, --check-density, --check-fonts, and --check-visual. It performs a silent version check at task start, loads an optional brand profile (~/.config/kami/brand.md), and for landing pages generates a deployable static HTML file with carousels, responsive breakpoints, and multilanguage companions.
- A founder needs a polished one-pager for investors or clients without wrestling with default document styling.
- A PM turns a 20-page research report into a structured 6-15 page long doc with charts and clear hierarchy.
- A job seeker builds an English or Chinese resume that follows strict writing rules (action-scope-result-outcome) and fits tight page-density targets.
- A speaker converts existing content into slides with PDF, PPTX, or Marp output paths.
- A developer wants a product landing page with hero animation, gallery carousel, responsive breakpoints, and multi-language support.
What are this skill's strengths and limitations?
- A unified visual system that eliminates AI output style drift and produces professional, consistent documents.
- Covers a wide range of document types and languages (EN/CN/JA/KO), plus a landing-page system.
- Built-in quality gates: content schema validation, density checks, font checks, visual checks — ensuring high-quality deliverables.
- Flexible slide paths: WeasyPrint PDF, editable PPTX, and Marp Markdown.
- Optional brand profile lets you personalize while keeping consistency.
- Requires Python 3 and WeasyPrint (plus optional Pygments); not zero-configuration.
- The Chinese font (TsangerJinKai02) is free only for personal use; commercial use needs a license, and font files are not bundled (scripts recover them).
- Some features (e.g., product site system, screenshot verification) assume an agent with filesystem and image-generation access.
- Deliberately limited to a warm parchment aesthetic — unsuitable for dark/cyberpunk or high-saturation designs.
How do you install this skill?
Kami is a monorepo with multiple skills; install the relevant bundle via:
- Claude Code (v2.1.142+): /plugin marketplace add tw93/kami then /plugin install kami@kami.
- Codex CLI: codex plugin marketplace add tw93/kami then codex plugin add kami@kami.
- Claude Desktop: download kami.zip from GitHub Releases and upload in Customize > Skills > create skill.
- Generic agents: npx skills add tw93/kami/plugins/kami -a universal -g -y.
How do you use this skill?
No slash command needed — just describe your need naturally. Examples:
- English: "make a one-pager for my startup", "turn this research into a long doc", "build me a resume", "design a slide deck".
- 中文: "帮我做一份一页纸", "帮我排版一份长文档", "帮我做一份简历".
- Japanese and Korean prompts are also documented.
The skill picks the matching template and language, then reports deliverable paths and verification results when done.