From agent-almanac
Creates Quarto documents for reproducible reports, presentations, or websites. Covers YAML configuration, code chunks, cross-references, and rendering for HTML, PDF, or Word output.
How this skill is triggered — by the user, by Claude, or both
Slash command
/agent-almanac:create-quarto-reportThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Set up and write a reproducible Quarto document for analysis reports, presentations, or websites.
Set up and write a reproducible Quarto document for analysis reports, presentations, or websites.
Create report.qmd:
---
title: "Analysis Report"
author: "Author Name"
date: today
format:
html:
toc: true
toc-depth: 3
code-fold: true
theme: cosmo
self-contained: true
execute:
echo: true
warning: false
message: false
bibliography: references.bib
---
Expected: File report.qmd exists with valid YAML frontmatter including title, author, date, format configuration, and execution options.
On failure: Validate the YAML header by checking for matching --- delimiters and correct indentation. Ensure format: key matches one of the supported Quarto output formats (html, pdf, docx, revealjs).
## Introduction
This report analyzes the relationship between variables X and Y.
## Data
```{r}
#| label: load-data
library(dplyr)
library(ggplot2)
data <- read.csv("data.csv")
glimpse(data)
```
## Analysis
```{r}
#| label: fig-scatter
#| fig-cap: "Scatter plot of X vs Y"
#| fig-width: 8
#| fig-height: 6
ggplot(data, aes(x = x_var, y = y_var)) +
geom_point(alpha = 0.6) +
geom_smooth(method = "lm") +
theme_minimal()
```
As shown in @fig-scatter, there is a positive relationship.
## Results
```{r}
#| label: tbl-summary
#| tbl-cap: "Summary statistics"
data |>
summarise(
mean_x = mean(x_var),
sd_x = sd(x_var),
mean_y = mean(y_var),
sd_y = sd(y_var)
) |>
knitr::kable(digits = 2)
```
See @tbl-summary for descriptive statistics.
Expected: Content sections contain properly formatted code chunks with {r} language identifier and #| chunk options for labels, captions, and dimensions.
On failure: Verify code chunks use the ```{r} syntax (not inline backticks), that #| options are inside the chunk (not in the YAML header), and that label prefixes match cross-reference types (fig- for figures, tbl- for tables).
Common chunk-level options (use #| syntax):
#| label: chunk-name # Required for cross-references
#| echo: false # Hide code
#| eval: false # Show but don't run
#| output: false # Run but hide output
#| fig-width: 8 # Figure dimensions
#| fig-height: 6
#| fig-cap: "Caption text" # Enable @fig-name references
#| tbl-cap: "Caption text" # Enable @tbl-name references
#| cache: true # Cache expensive computations
Expected: Chunk options are applied at the chunk level using #| syntax, and labels follow naming conventions required for cross-referencing.
On failure: Ensure chunk options use #| syntax (Quarto-native), not the legacy {r, option=value} R Markdown syntax. Verify that label names contain only alphanumeric characters and hyphens.
See @fig-scatter for the visualization and @tbl-summary for statistics.
This approach follows @smith2023 methodology.
::: {#fig-combined layout-ncol=2}
{#fig-plotA}
{#fig-plotB}
Combined figure caption
:::
Expected: Cross-references (@fig-name, @tbl-name) resolve to the correct figures and tables, and citations (@key) match entries in the .bib file.
On failure: Verify that referenced labels exist in code chunks with the correct prefix (fig-, tbl-). For citations, check that .bib keys match exactly (case-sensitive) and that bibliography: is set in the YAML header.
quarto render report.qmd
# Specific format
quarto render report.qmd --to pdf
quarto render report.qmd --to docx
# Preview with live reload
quarto preview report.qmd
Expected: Output file generated in the specified format.
On failure:
quarto install tinytexformat:
html:
toc: true
theme: cosmo
pdf:
documentclass: article
geometry: margin=1in
docx:
reference-doc: template.docx
Render all formats: quarto render report.qmd
Expected: All specified output formats generate successfully, each with correct styling and layout for the target format.
On failure: If one format fails while others succeed, check format-specific requirements: PDF needs a LaTeX engine (install with quarto install tinytex), DOCX needs a valid reference template if specified, and format-specific YAML options must be correctly nested under each format key.
fig- prefix in label, tables need tbl-_cache/ to force.format: pdf with pdf-engine: weasyprint for CSS-based PDF#| chunk options instead of {r, echo=FALSE} styleformat-apa-report - APA-formatted academic reportsbuild-parameterized-report - parameterized multi-report generationgenerate-statistical-tables - publication-ready tableswrite-vignette - Quarto vignettes in R packagesnpx claudepluginhub pjt222/agent-almanacGenerates interactive Quarto HTML reports from research experiment data and findings, with figures, data exploration, blogpost structure, and writing guidelines.
Generates APA 7th edition formatted reports using Quarto (apaquarto) or R Markdown (papaja) with title page, abstract, citations, tables, figures, and reference formatting.
Generates PDF, DOCX, HTML, ODT, EPUB, RTF documents from markdown using pandoc. For user requests to create reports, export findings, code reviews, or save analysis as formatted files.