deploy
Render Quarto `.qmd` slides to HTML and sync to `docs/` for GitHub Pages. Use when user says "deploy", "publish the slides", "ship to pages", "push the lecture live", "render and publish", or after Quarto edits that need to go public. NOT for local Quarto render only — use `quarto render` directly for that.
Install
npx skillscat add pedrohcgs/claude-code-my-workflow/deploy Install via the SkillsCat registry.
This skill renders Quarto .qmd slide files to HTML and syncs the output along with associated assets (figures, R scripts, RevealJS files) to the docs/ directory for GitHub Pages deployment. It automates the process of publishing slide decks publicly, handling rendering, file copying, and asset synchronization. Use it when deploying, publishing, or updating slides for web hosting, but not for local-only Quarto rendering.
Deploy Slides to GitHub Pages
Render Quarto slides and sync all files to docs/ for GitHub Pages deployment.
Steps
Run the sync script:
- If
$ARGUMENTSis provided (e.g., "Lecture4"):./scripts/sync_to_docs.sh $ARGUMENTS - If no argument:
./scripts/sync_to_docs.sh(syncs all lectures)
- If
Verify deployment:
- Check that HTML files exist in
docs/slides/ - Check that
_files/directories were copied (RevealJS assets) - Check that
docs/Figures/was synced fromFigures/ - Check that
docs/files/code/contains the R scripts (ifscripts/R/has any)
- Check that HTML files exist in
Verify interactive charts (if applicable):
- Grep rendered HTML for interactive widget count
- Confirm count matches expected
Verify TikZ SVGs (if applicable):
- Check that all referenced SVG files exist in
docs/Figures/LectureN/
- Check that all referenced SVG files exist in
Open in browser for visual verification:
open docs/slides/LectureX_Name.html# macOS# xdg-open docs/slides/LectureX_Name.html# Linux- Confirm slides render, images display, navigation works
Report results to the user
What the sync script does:
- Renders all
.qmdfiles inQuarto/(skips*_backup*files) - Copies HTML and
_files/directories todocs/slides/ - Copies Beamer PDFs from
Slides/todocs/slides/ - Syncs
Figures/todocs/Figures/using rsync - Copies every
scripts/R/*.Rintodocs/files/code/(published beside the slides)
Install
npx skillscat add pedrohcgs/claude-code-my-workflow/deploy Install via the SkillsCat registry.
Repository Stars
The star count shown is for the parent repository (pedrohcgs/claude-code-my-workflow), not this specific skill.
.claude/skills/deploy