Deploy Slides to GitHub Pages
SkillDocs & knowledgeRender 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.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Deploy Slides to GitHub Pages skill
What this skill tells your AI
The instructions your AI receives, as published by pedrohcgs/claude-code-my-workflow in .claude/skills/deploy/SKILL.md and read by ahel’s review.
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)
Signals
- GitHub stars
- 2k
- Forks
- 3k
- Last commit
- Aug 2026
Advanced
- Catalog kind
- skill
- Gateway key
deploy-pedrohcgs- Source
- github.com/pedrohcgs/claude-code-my-workflow