mcpbeat

Deploy

pedrohcgs/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.

428 tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
1440
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository 
npx skills add https://github.com/pedrohcgs/claude-code-my-workflow --skill deploy

The instruction itself

3 sections, as written by the author

Deploy Slides to GitHub Pages

Render Quarto slides and sync all files to docs/ for GitHub Pages deployment.

Steps

  • 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)
  • 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/
  • 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/
  • 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 .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

How to use it

Copy the folder

Take pedrohcgs/deploy from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.