1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | Quarto Authoring（quarto-authoring-posit-dev-skills） |
| 作者/维护者 | Posit PBC（posit-dev 组织），主要维护者 Mickaël Canouil，另有 Garrick Aden-Buie、Emil Hvitfeldt、Kristoffer Bjärkefur 等参与 |
| 来源链接 | github.com/posit-dev/skills/tree/main/quarto/quarto-authoring |
| 许可证 | MIT（GitHub API 确认） |
| GitHub Stars | 合集仓库整体 443（GitHub API）；该数字属整个 posit-dev/skills 合集，不代表本技能自身热度 |
| Forks | 合集仓库整体 35（GitHub API） |
| 最新版本 | SKILL.md 内声明 version “1.4” |
| 安装方式 | Claude Code 插件市场一键安装，或跨 Agent CLI npx skills add |
2. 功能介绍与亮点
Quarto Authoring 是 Posit（原 RStudio 公司）官方发布的技术文档写作技能，教 Agent 正确使用 Quarto——一个能把 Markdown 风格的 .qmd 源文件渲染成 PDF、Word、HTML、演示文稿、书籍、仪表盘等多种格式的开源出版系统。
核心能力：
- 完整语法覆盖：交叉引用（图/表/公式/章节）、代码单元格配置、图表与题注、表格、引用与参考文献、Callout 提示框、Mermaid/Graphviz 图表、页面布局、Shortcode、条件内容、YAML 头信息、扩展查找。SKILL.md 主文件配合 21 份独立参考文档，按需加载，覆盖面细致。
- 迁移指导：明确给出从 R Markdown（.Rmd）、bookdown、blogdown、xaringan、distill、Jupyter Notebook 迁移到 Quarto 的具体步骤，是团队升级旧文档体系时的实用向导。
- 计算引擎配置：支持 knitr（R）、Jupyter（Python）、Julia 多种计算后端的选择与配置说明。
亮点：
- 官方一线机构出品，代码托管在 Posit 官方
posit-dev组织下，MIT 许可证完全开源。 - 技能本身经历过多轮真实迭代——语言无关化重构、精简 token 占用约 22%、修复失效链接等，说明维护者持续打磨内容质量而非一次性发布后放手。
- 纯知识/参考型技能，不依赖任何付费 API 或凭据，只需本地安装免费开源的 Quarto CLI 即可配合使用。
3. 适用场景
所属分类：文档与办公自动化
适合需要产出正式技术文档、科研报告、技术书籍、演示文稿或数据仪表盘的用户——数据科学家、科研人员、技术写作者、需要把分析结果整理成可发布文档的工程师。尤其适合正在把旧的 R Markdown / bookdown / blogdown / xaringan 项目迁移到 Quarto、或初次接触 Quarto 复杂语法（交叉引用、Callout、Shortcode 等）需要 Agent 辅助的场景。
4. 跨 Agent 兼容性
- Claude Code：原生支持，官方提供插件市场一键安装（
/plugin marketplace add posit-dev/skills后/plugin install quarto@posit-dev-skills）。 - Codex / OpenClaw / Hermes Agent：该仓库 README 明确推荐通过跨 Agent 安装工具
npx skills add posit-dev/skills分发本技能，该安装器官方文档列出支持 70 余种 Agent，其中明确包含 Codex、OpenClaw、Hermes Agent。SKILL.md 本身遵循与 Agent 无关的标准格式（YAML front matter + 指令正文），三端均可通过该安装器获取同一份技能内容，但未见针对这三端逐一实测验证的说明。
5. 推荐理由
Quarto 是数据科学与技术写作领域被广泛使用的开源出版系统，而 Quarto 自身语法（尤其是交叉引用、Shortcode、YAML 配置）对新手并不直观。这份技能由 Quarto 的官方生态方 Posit 直接出品并持续打磨，把常被查文档才能搞定的细节（如从 R Markdown 迁移的具体步骤）整理成 Agent 可直接调用的结构化参考，能显著减少用户在写作/排版细节上的来回试错，尤其对需要产出多种格式（PDF/HTML/Word/幻灯片）正式文档的用户价值明确。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | Posit PBC 官方出品；技能自身在近 8 个月内由 4 位具名工程师持续迭代（含语言无关化重构、精简 token、修复链接等 14 次提交），但作为合集内的一个子技能，专属讨论热度尚未达到独立爆款级别 |
| 可用性 | 9 | 提供 Claude Code 插件市场一键安装、跨 Agent CLI、手工克隆三种安装路径；21 份参考文档结构清晰、按需加载；最近一次提交距今约 2 个月，仓库整体最近一次提交约 3 周前；无需任何付费依赖 |
| 安全性 | 9 | 纯提示词/参考文档类技能，不执行 shell 命令、不联网外发数据、不索取任何 API Key 或凭据；MIT 许可证明确；作者为具名真实工程师，逐条提交记录审阅未见可疑指令或运营操纵痕迹 |
安全检查清单：
① Shell 命令与权限范围——无，本技能不声明任何 allowed-tools，纯文本参考内容
② 联网外发数据——无，全部内容为静态参考文档
③ API Key/凭据——不需要；仅要求本地已安装免费开源的 Quarto CLI 用于实际渲染文档，技能本身不索取任何密钥
④ 可疑指令/Prompt Injection——SKILL.md 及 21 份参考文档通读未发现
⑤ 作者/组织信誉——Posit PBC 官方组织，提交记录含 4 位具名工程师的真实功能迭代，未见 SEO 操纵或刷星痕迹
⑥ License——MIT，仓库根目录 LICENSE 文件与 SKILL.md front matter 双重确认
⑦ 最近维护——技能目录最近提交约 2 个月前，仓库整体约 3 周前，处于活跃维护状态
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与 Quarto Authoring 的差异 |
|---|---|---|
| Tufte 数据可视化类技能（如已有的可视化设计原则技能） | 教 Agent 遵循 Edward Tufte 的图表设计美学原则 | 聚焦“图表该长什么样”的设计规范，不涉及 Quarto 这类完整出版系统的语法、多格式渲染与项目迁移 |
| 通用 Markdown 转 PPT / HTML 幻灯片类技能 | 把文本一键转成演示文稿或网页 | 侧重单一输出格式（幻灯片/网页），不覆盖 Quarto 支持的 PDF、Word、书籍、仪表盘等多格式输出，也不含从 R Markdown 等旧格式迁移的专门指导 |
| 通用 PDF/Word 报告生成技能 | 面向办公文档的排版与生成 | 不具备 Quarto 特有的交叉引用、Callout、Shortcode、计算引擎（knitr/Jupyter/Julia）集成等面向技术写作与可复现研究报告的能力 |
Quarto Authoring 的差异化在于：它不是通用的“文本转文档”工具，而是深度绑定 Quarto 这一开源出版系统本身的语法与生态（含从五种旧格式迁移的具体指导），适合已经或计划采用 Quarto 技术栈做技术写作、科研发表的用户。
8. 用户评价
该技能目前未见独立于 Posit 官方之外、具名可查证的第三方用户评价。
9. 其他补充
该技能是 posit-dev/skills 官方合集仓库的一部分，同一仓库内还包含面向 R 包开发、GitHub PR 工作流、Shiny 应用主题、ggsql 数据可视化查询等多个独立技能类别，供有相关需求的用户按需选装。
10. 安装使用方式
方式一：Claude Code 插件市场（推荐）
/plugin marketplace add posit-dev/skills
/plugin install quarto@posit-dev-skills方式二：跨 Agent 安装 CLI（支持 Claude Code / Codex / OpenClaw / Hermes Agent 等）
npx skills add posit-dev/skills --skill quarto-authoring方式三：手工安装
git clone https://github.com/posit-dev/skills.git
# 将 quarto/quarto-authoring 目录复制到对应 Agent 的 skills 目录安装后无需重启，Agent 会在检测到用户涉及 Quarto、.qmd 文件、_quarto.yml 或相关迁移需求时自动触发该技能。实际渲染文档仍需本地安装免费开源的 Quarto CLI。
11. 注意事项
- 本技能提供的是写作/语法指导与最佳实践，实际将
.qmd渲染为最终文档仍依赖用户本机安装 Quarto CLI（免费开源，不在本技能范围内）。 - 内容基于 Quarto CLI v1.9.36（2026-03-24）编写，若后续 Quarto 版本引入语法变化，技能内容可能需要相应更新。
- 作为合集仓库中的一个子技能，安装时建议按需选择具体类别（如仅安装
quarto），避免一次性拉入其他与自身工作无关的类别（如 R 包开发、Shiny 主题等）。