typst-skill
在 Claude 等 AI 对话中直接编译和预览 Typst 文档。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：typst-skill。 它的用途是：在 Claude 等 AI 对话中直接编译和预览 Typst 文档。 完整的 Skill 内容见：https://321skill.com/skills/typst-skill-typst-skill/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请帮我编译这段 Typst 简历代码，看看排版效果。”，它会调用 typst-skill，在后台编译你的代码，并将生成的 PDF 预览图或文件返回给你，方便你即时查看和调整格式。或者当你写论文时说：“这是论文的 Typst 主体，编译一下生成 PDF 看看图表位置。”，AI 会执行编译并反馈结果。
介绍
Typst-Skill 解决了在 AI 对话环境中无法直接编译和预览 Typst 排版文档的痛点。用户无需离开对话窗口，即可将 Typst 代码片段发送给 AI，由该技能调用本地 Typst 编译器进行编译，并生成 PDF 或 PNG 预览图返回给用户，实现代码到排版的即时可视化。
使用方式非常简单：在支持的 AI 平台（如 Claude Desktop）中安装此技能后，当对话中需要处理 Typst 内容时，AI 会自动调用该技能。用户只需提供 Typst 代码或提及需要编译 Typst 文件，AI 便会处理编译请求并返回结果。
它非常适合经常使用 Typst 撰写学术论文、技术文档、报告或简历的内容创作者、学术研究者和高校学生。对于需要在 AI 辅助下快速迭代文档排版效果的用户来说，它能极大提升效率。
建议在使用前确保本地已正确安装 Typst 编译器。由于依赖本地环境，在无 Typst 环境的服务器或受限环境中可能无法使用。编译复杂文档或使用特殊字体时，需注意本地环境与技能调用的兼容性。
核心特点
与仅能高亮或解释 Typst 语法的 AI 技能不同，本技能的核心在于能实际调用本地 Typst 编译器执行编译，并返回可查看的 PDF/PNG 文件，实现了从代码到成品的“执行”环节，而不仅仅是“分析”或“建议”。
注意事项
不适合在未安装 Typst 编译器的环境或纯 Web 端 AI 服务中使用。
常见问题
安装后 AI 不编译 Typst 代码怎么办？
请先确认本地已安装 Typst CLI 且命令可执行，并检查技能配置是否正确指向了 Typst 命令路径。
能编译复杂的、包含多文件引用的 Typst 项目吗？
技能主要针对单文件或简单引用场景，复杂项目可能因路径问题需要额外配置。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/typst-skill-typst-skill/raw/index.md 读取 typst-skill 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/typst-skill-typst-skill/raw/index.md（查看排版版本）