Skip to content

■ SKILLS // SKILL SPECS

quarto

Collection of skills for Quarto document creation

■ [!] ON THIS PAGE ▼
■ INSTALL // npx @self.md/cli install quarto
AuthorGarrick Aden-Buie (Posit, PBC)
Namespace@posit-dev/posit-dev-skills
Category#general
Version1.0.0
Stars★ 73
Downloads↓ 4
Verification[ ✓ ] self.md verified

Collection of skills for Quarto document creation

Installation

npx claude-plugins install @posit-dev/posit-dev-skills/quarto

Contents

Folders: authoring

Files: README.md

Documentation

Skills for Quarto document creation and publishing.

Overview

This category contains skills that help with creating, styling, and publishing Quarto documents, presentations, websites, and PDFs. Skills support all major Quarto output formats.

Available 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. See detailed documentation below .

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:

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.

Resources


Skills

Quarto Authoring Skill

Comprehensive guidance for Quarto document authoring and R Markdown migration.

This skill provides best practices for writing Quarto documents (.qmd) and converting existing R Markdown projects to Quarto. It covers the full range of Quarto authoring features including code cells, cross-references, figures, tables, citations, callouts, diagrams, and more.

When to Use This Skill

  • 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.

Skills Reference Documentation

Quarto Features
ReferenceDescription
code-cells.mdHashpipe syntax, execution options, code display
cross-references.mdLabels, prefixes, all reference types
figures.mdFigures, subfigures, layouts, lightbox
tables.mdPipe tables, grid tables, styling
citations.mdBibliography, CSL, footnotes
callouts.mdCallout types, appearance, collapsible
diagrams.mdMermaid, Graphviz/DOT diagrams
[layout.md](authoring/references/l

Source

View on GitHub