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 `quart
Install
npx skills add https://github.com/pedrohcgs/claude-code-my-workflow/tree/main/.claude/skills/deploy
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install pedrohcgs-claude-code-my-workflow@llmmart
git clone https://github.com/pedrohcgs/claude-code-my-workflow.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole pedrohcgs/claude-code-my-workflow collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
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)
Files (claude-code-my-workflow)
-
SKILL.md 1.8 KB
--- 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)
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.