Skip to main content

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.

Source facts

Repository
pedrohcgs/claude-code-my-workflow
Last source activity
August 22, 2026 at 22:34
Detected SKILL.md language
English
Stars
1,657
Forks
3,107

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
name
deploy
description
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.
argument-hint
[LectureN or 'all']
allowed-tools
["Read","Bash"]
# Deploy Slides to GitHub Pages Render Quarto slides and sync all files to `docs/` for GitHub Pages deployment. ## Steps 1. **Run the sync script:** - If `$ARGUMENTS` is provided (e.g., "Lecture4"): `./scripts/sync_to_docs.sh $ARGUMENTS` - If no argument: `./scripts/sync_to_docs.sh` (syncs all lectures) 2. **Verify deployment:** - Check that HTML files exist in `docs/slides/` - Check that `_files/` directories were copied (RevealJS assets) - Check that `docs/Figures/` was synced from `Figures/` - Check that `docs/files/code/` contains the R scripts (if `scripts/R/` has any) 3. **Verify interactive charts** (if applicable): - Grep rendered HTML for interactive widget count - Confirm count matches expected 4. **Verify TikZ SVGs** (if applicable): - Check that all referenced SVG files exist in `docs/Figures/LectureN/` 5. **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 6. **Report results** to the user ## What the sync script does: - Renders all `.qmd` files in `Quarto/` (skips `*_backup*` files) - Copies HTML and `_files/` directories to `docs/slides/` - Copies Beamer PDFs from `Slides/` to `docs/slides/` - Syncs `Figures/` to `docs/Figures/` using rsync - Copies every `scripts/R/*.R` into `docs/files/code/` (published beside the slides)
View on GitHub