Quarto Skills

Skills for Quarto document creation and publishing.

Skills

authoring

Comprehensive guidance for Quarto document authoring and R Markdown migration. Write new Quarto documents with best practices, convert R Markdown files, migrate bookdown/blogdown/xaringan/distill projects, and use Quarto-specific features like hashpipe syntax, cross-references, callouts, and extensions.

When to Use

• Writing new Quarto documents with best practices.
• Converting R Markdown (.Rmd) files to Quarto (.qmd).
• Migrating bookdown, blogdown, xaringan, or distill projects.
• Understanding Quarto's cell options syntax (comment symbol + |).
• Setting up cross-references for figures, tables, sections, and equations.
• Using Quarto-specific features like callouts, divs, and spans.
• Configuring YAML front matter for documents and projects.
• Finding and using Quarto extensions.

Maintenance

• Review skill content when new Quarto versions are released.
• Check the Quarto changelog for breaking changes and new features.
• Cross-check syntax examples against Quarto Documentation.
• Update examples to reflect current best practices.
• Remove deprecated syntax or features.

Reference Documentation

Quarto Features

Reference	Description
code-cells.md	Hashpipe syntax, execution options, code display
cross-references.md	Labels, prefixes, all reference types
figures.md	Figures, subfigures, layouts, lightbox
tables.md	Pipe tables, grid tables, styling
citations.md	Bibliography, CSL, footnotes
callouts.md	Callout types, appearance, collapsible
diagrams.md	Mermaid, Graphviz/DOT diagrams
layout.md	Column classes, margin content
shortcodes.md	Built-in shortcodes
conditional-content.md	Format-specific content
divs-and-spans.md	Fenced divs, spans, raw blocks
yaml-front-matter.md	Document and project YAML
extensions.md	Using and finding extensions

Migration Guides

Reference	Description
conversion-rmarkdown.md	R Markdown to Quarto
conversion-bookdown.md	bookdown to Quarto
conversion-xaringan.md	xaringan to RevealJS
conversion-distill.md	distill to Quarto
conversion-blogdown.md	blogdown to Quarto website

Resources

• Quarto Documentation
• Quarto Guide
• Quarto Extensions
• Quarto CLI Code
• Community Extensions List

Authors

• Mickaël CANOUIL

---

brand-yml

Create and use _brand.yml files for consistent branding across Quarto documents and Shiny applications. Use when working with brand styling, corporate identity, colors, fonts, or logos in Quarto projects.

Organization: Main skill file includes workflows and decision tree. Reference files provide framework-specific integration guides:

• brand-yml-spec.md - Complete brand.yml specification
• shiny-r.md - Shiny for R integration with bslib
• shiny-python.md - Shiny for Python integration with ui.Theme
• quarto.md - Quarto integration for all formats (HTML, dashboards, RevealJS presentations, Typst PDFs, websites)

Note: This skill is also registered in the shiny category since brand.yml works across both Shiny and Quarto projects.

Resources

• brand.yml project
• Quarto brand.yml docs
• Shiny for R brand.yml guide
• Shiny for Python brand.yml docs

---

alt-text

Generate and improve accessible alt text for data visualizations and images in Quarto documents and R packages. Use when adding, improving, or auditing fig-alt for figures in .qmd files, or when making documents more accessible for screen readers.

Organization: Uses progressive disclosure with reference files. The main skill detects the project type (pkgdown vs. Quarto) and loads the relevant reference.

Note: This skill is also registered in the r-lib category since it covers both Quarto documents and pkgdown sites.

Potential Skills

This category could include skills for:

• Publishing workflows
• Extension development
• Template creation
• Multi-format output
• Parameterized reports
• Website and book publishing
• Presentation design

Contributing

See the main CONTRIBUTING.md for guidelines on adding new skills to this category. We encourage you to use Anthropic's skill-creator when building new skills.