deploy

Render Quarto slide projects and publish them to the gh-pages branch.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/gerhardriener/EC5230-industrial-organisation --skill deploy-gerhardriener
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deploy
Source: https://github.com/gerhardriener/EC5230-industrial-organisation/tree/main/.claude/skills/deploy
Command: npx skills add https://github.com/gerhardriener/EC5230-industrial-organisation --skill deploy-gerhardriener

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill streamlines the deployment of Quarto slide projects by automating the rendering and publishing steps to GitHub Pages, reducing manual effort and potential errors.

Core Features & Use Cases

  • Automated rendering of Quarto projects
  • Publishing to the gh-pages branch on GitHub
  • Validation steps to ensure site integrity and link checks for lecture slides

Quick Start

Run the deploy script to render all slides and publish to the gh-pages branch.

Frequently Asked Questions about deploy

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

FAQPage Schema
How do I deploy Quarto slides to GitHub Pages automatically?

You can deploy Quarto slides to GitHub Pages by running a publish script that renders the site, checks interactive elements and generated assets, and pushes the output directly to the gh-pages branch.

What do I need to publish Quarto lecture slides to a GitHub repository?

Publishing Quarto lecture slides requires a local Quarto installation, a configured GitHub repository, and a deploy script (e.g., scripts/sync_to_docs.sh) to handle rendering and push the generated site to the gh-pages branch.

Does the Quarto deployment process include validation for generated assets?

Yes, the Quarto deployment process includes optional validation steps that check site integrity, verify interactive elements, and ensure generated assets are correctly rendered before publishing to GitHub Pages.

Can I use this GitHub Pages deployment method for a series of lecture slides?

Yes, this deployment method works across lecture-series deployments by utilizing a publish script to render all Quarto slides and push the complete project to the gh-pages branch on GitHub.

Why is my Quarto site not publishing to the gh-pages branch?

Publishing to the gh-pages branch can fail if the local Quarto installation is missing, the GitHub repository is not properly configured, or the required deploy script (e.g., scripts/sync_to_docs.sh) is absent or incorrectly set up.