Typst Skill

Current version: Typst 0.14.2 (Dec 2025)

Smart Defaults

If you know nothing else, follow these rules:

1. Always import @local/qk:2.1.0 — #import "@local/qk:2.1.0": *
2. Always use qk-doc or qk-report preset (unless user specifies custom)
3. Always use touying for presentations (not raw page dimensions) — see references/touying-guide.md
4. Always #set figure(placement: auto) — prevents blank half-pages
5. Always add alt: to images — image("path.png", alt: "description")
6. Always escape $ in content — scan for bare $ before compiling
7. Default fonts: Libertinus Serif (body), Inter (headings), New Computer Modern Math (math), Fira Code (code)
8. Default compile: typst compile --root .. Source/<file>.typ
9. When in doubt about template: Study Guide
10. When in doubt about visual tool: diagrams → fletcher; charts → see decision tree (simple → cetz-plot, statistical → matplotlib+seaborn, grammar → plotnine, complex → matplotlib)
11. Always scan project for existing .typ files and match their style (fonts, colors, qk preset) unless user specifies otherwise