Quarto Authoring

What it does

When your agent uses it

• The user is explicitly working with Quarto
• Quarto projects
• Quarto features such as callouts
• Cross-references

Example prompts

• “/quarto-authoring”

Requirements

• Python 3

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

1. 1YAML Front Matter: Metadata and configuration at the top, enclosed by ---.
2. 2Markdown Content: Main body using standard markdown syntax.

What it can do on your machine

Read from SKILL.md and the folder at commit bd2329a. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • pip

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Links to these hosts (documentation or services it may open):

  • quarto.org
  • m.canouil.dev

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Quarto Authoring loads about 1.9k tokens when it runs, and up to ~29k if it reads all its reference files. Until then it costs about 129 tokens; SKILL.md has 457 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~129

When it runs · the whole SKILL.md, loaded when a task matches

~1.9k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~29k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from quarto-dev/quarto-r at commit bd2329a, republished under its MIT licence (© quarto-dev). 457 words, ~1,859 tokens.

name

quarto-authoring

description

Use when the user is explicitly working with Quarto, .qmd files, _quarto.yml, Quarto projects, or Quarto features such as callouts, cross-references, citations, Mermaid diagrams, extensions, websites, books, presentations, and reports. Also use for explicit migration from or comparison with R Markdown, bookdown, blogdown, xaringan, distill, or Jupyter notebooks to Quarto. Do not use for general R Markdown or related-format questions unless Quarto or migration to Quarto is explicitly mentioned.

metadata.author

Mickaël Canouil (@mcanouil)

metadata.version

1.4

license

MIT

---
title: "Document Title"
author: "Author Name"
date: today
format: html
---

Content goes here.

::: {.class-name}
Content inside the div.
:::

This is [important text]{.highlight}.

```{language}
#| label: fig-example
#| echo: false
#| fig-cap: "A scatter plot example."

# code that produces a figure
```

execute:
  echo: false
  warning: false

execute:
  cache: true

```{language}
#| label: fig-plot
#| fig-cap: "A caption for the plot."

# code that produces a figure
```

See @fig-plot for the results.

::: {.callout-note}
This is a note callout.
:::

::: {.callout-warning}

## Custom Title

This is a warning with a custom title.

:::

![Caption text](image.png){#fig-name fig-alt="Alt text"}

::: {#fig-group layout-ncol=2}
![Sub caption 1](image1.png){#fig-sub1}

![Sub caption 2](image2.png){#fig-sub2}

Main caption for the group.
:::

::: {#tbl-example}

| Column 1 | Column 2 |
| -------- | -------- |
| Data 1   | Data 2   |

Table caption.
:::

According to @smith2020, the results show...
Multiple citations [@smith2020; @jones2021].

bibliography: references.bib
csl: apa.csl

title: "My Report"
author: "Your Name"
date: today
format:
  html:
    toc: true
    code-fold: true
    theme: cosmo

title: "My Report"
format:
  pdf:
    documentclass: article
    papersize: a4

---
title: "My Presentation"
format: revealjs
---

## First Slide

Content here.

## Second Slide

More content.

project:
  type: website

website:
  title: "My Site"
  navbar:
    left:
      - href: index.qmd
        text: Home
      - href: about.qmd
        text: About

format:
  html:
    theme: cosmo

© quarto-dev, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 21 other files (references) in .claude/skills/quarto-authoring of quarto-dev/quarto-r.

• SKILL.md
• references/callouts.md
• references/citations.md
• references/code-cells.md
• references/conditional-content.md
• references/conversion-blogdown.md
• references/conversion-bookdown.md
• references/conversion-distill.md
• references/conversion-jupyter.md
• references/conversion-rmarkdown.md
• references/conversion-xaringan.md
• references/cross-references.md
• references/diagrams.md
• references/divs-and-spans.md
• references/engines.md
• references/extensions.md
• references/figures.md
• references/layout.md
• references/markdown-linting.md
• references/shortcodes.md
• … and 2 more

Open the folder on GitHubat commit bd2329a

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in quarto-dev/quarto-r, which our catalogue first saw on October 7, 2026.

• posit-dev/skillsquarto/quarto-authoring