Skills for Quarto document creation and publishing.
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.
- 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.
- 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 | 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 |
| 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 |
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.
Write Lua shortcodes and filters for Quarto. Covers shortcode handlers, Pandoc AST filters, Lua coding conventions, Quarto-specific Lua APIs, and common patterns. Includes runtime access to Quarto's LLM-optimised documentation (.llms.md pages) for detailed API reference.
Generate accessible alt text for data visualizations in Quarto documents. Use when adding, improving, or reviewing fig-alt for figures in .qmd files, or when making documents more accessible for screen readers.
This category could include skills for:
- Publishing workflows.
- Template creation.
- Multi-format output.
- Parameterized reports.
- Website and book publishing.
- Presentation design.
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.