typst-writer 是 ypares/agent-skills 中的一项技能，用于编写正确、地道的 Typst 文档排版代码，适用于创建或编辑 Typst（.typ）文件、处理 Typst 标记或回答相关问题时。其核心原则是：不要假设其他语言的语法适用于 Typst，遇到不确定的语法应核对官方文档，并采用地道写法。
Typst 关键语法区别包括：数组用圆括号 (item1, item2)，字典用带冒号的圆括号 (key: value)，内容块用方括号 [markup content]，没有元组，数组元素用 arr.at(0) 访问，标记语境中的代码需要 # 前缀，注意区分内容块 [] 与代码块 {}。推荐用 #let name(params) = { ... } 定义函数，访问状态时使用 context 块。
该技能强调通过 #set、#show 和自定义函数避免内容与布局混杂，保持文档视觉一致性；优先利用 Typst 的合理默认值和简洁写法，例如用 强调 而非 #emph[强调]，直接写 π 而非 #sym.pi。包通过 #import "@preview/package:version" 导入，模板用 #show: 模板名.with(...) 应用；可用 typst query 配合选择器以 JSON 形式读取文档内容，例如 typst query the_document.typ "heading.where(level: 1)" | jq ".[].body.text"。大文档可用 #include 拆分，并支持 typst compile doc.typ output.pdf --pages 1-5 等编译选项。
限制与注意事项：Typst Universe 没有程序化 API，可用 GitHub 搜索包；导入失败时应核对包名版本与网络；字体警告不阻止编译但会使用回退字体。资料未提供该技能的安装命令、收费方式与平台支持等事实。