rstudio-update-quarto

Updates the pinned Quarto version across the RStudio codebase and mirrors release archives to S3.

5.0k|1.2k|Updated Dec 7, 2010
One-click install
npx skills add https://github.com/rstudio/rstudio --skill rstudio-update-quarto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rstudio-update-quarto
Source: https://github.com/rstudio/rstudio/tree/main/.claude/skills/rstudio-update-quarto
Command: npx skills add https://github.com/rstudio/rstudio --skill rstudio-update-quarto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bumping the Quarto dependency in the RStudio repository requires editing four files with different syntaxes, mirroring release archives to the rstudio-buildtools S3 bucket, and verifying the install — a multi-step process where silent script failures can break every platform's build.

Core Features & Use Cases

  • Version string updates: Edits NEWS.md, upload-quarto.sh, install-quarto, and install-dependencies.cmd, matching each file's exact syntax and verifying no stale pins remain.
  • S3 mirroring with verification: Runs the upload script, then independently validates archive checksums, S3 object sizes, and public readability rather than trusting exit codes.
  • Install verification and PR creation: Installs Quarto into a temporary tools root, confirms the binary reports the new version, and opens a pull request with the correct milestone.
  • Use Case: When Quarto releases version 1.9.36, run this skill to bump the pin, mirror all four platform archives, verify the install, and open the PR in one guided workflow.

Quick Start

Update the Quarto version in the RStudio repository to 1.9.36 and open a pull request.

Frequently Asked Questions about rstudio-update-quarto

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update the Quarto version in the RStudio repository?

Update the QUARTO_VERSION value in dependencies/tools/upload-quarto.sh, dependencies/common/install-quarto, and dependencies/windows/install-dependencies.cmd, plus the Quarto line in NEWS.md. Then run upload-quarto.sh to mirror the release to S3, verify the install, and open a PR.

Which files pin the Quarto version in RStudio?

Four files pin the version: NEWS.md (Dependencies section), dependencies/tools/upload-quarto.sh, dependencies/common/install-quarto, and dependencies/windows/install-dependencies.cmd. Each uses different syntax, so match the existing pattern exactly.

Does the Quarto update skill work on Windows?

No, this skill supports macOS and Linux only. It does edit the Windows install-dependencies.cmd file so Windows builds get the new version, but the update workflow itself must run on macOS or Linux.

Why does upload-quarto.sh report success when the upload failed?

The script has no set -e and never checks command status, so a failed wget still falls through to aws s3 cp and the exit code reflects only the final command. Verify results directly with checksum validation, S3 object size comparison, and anonymous HTTP requests.

What AWS permissions are needed to mirror Quarto to S3?

You need working AWS credentials with write access to the rstudio-buildtools S3 bucket, verified via aws sts get-caller-identity before starting. The upload requests public-read ACLs, so the bucket policy must also permit public objects.

Should archived release notes be updated when bumping Quarto?

No, files under version/news/os/ record what shipped in past releases and must be left unchanged. If the old version appears anywhere outside that directory, stop and report it rather than editing it.