publish-to-pages Publish any presentation or web content to GitHub Pages in one shot. 1. Prerequisites Check Run these silently. Only surface errors: command -v gh
/dev/null || echo "MISSING: gh CLI — install from https://cli.github.com" gh auth status &> /dev/null || echo "MISSING: gh not authenticated — run 'gh auth login'" command -v python3
/dev/null || echo "MISSING: python3 (needed for PPTX conversion)" poppler-utils is optional (PDF conversion via pdftoppm ). Don't block on it. 2. Input Detection Determine input type from what the user provides: Input Detection HTML file Extension .html or .htm PPTX file Extension .pptx PDF file Extension .pdf Google Slides URL URL contains docs.google.com/presentation Ask the user for a repo name if not provided. Default: filename without extension. 3. Conversion HTML No conversion needed. Use the file directly as index.html . PPTX Run the conversion script: python3 SKILL_DIR/scripts/convert-pptx.py INPUT_FILE /tmp/output.html If python-pptx is missing, tell the user: pip install python-pptx PDF Convert with the included script (requires poppler-utils for pdftoppm ): python3 SKILL_DIR/scripts/convert-pdf.py INPUT_FILE /tmp/output.html Each page is rendered as a PNG and base64-embedded into a self-contained HTML with slide navigation. If pdftoppm is missing, tell the user: apt install poppler-utils (or brew install poppler on macOS). Google Slides Extract the presentation ID from the URL (the long string between /d/ and / ) Download as PPTX: curl -L "https://docs.google.com/presentation/d/PRESENTATION_ID/export/pptx" -o /tmp/slides.pptx Then convert the PPTX using the convert script above. 4. Publishing Visibility Repos are created public by default. If the user specifies private (or wants a private repo), use --private — but note that GitHub Pages on private repos requires a Pro, Team, or Enterprise plan. Publish bash SKILL_DIR/scripts/publish.sh /path/to/index.html REPO_NAME public "Description" Pass private instead of public if the user requests it. The script creates the repo, pushes index.html , and enables GitHub Pages. 5. Output Tell the user: Repository: https://github.com/USERNAME/REPO_NAME Live URL: https://USERNAME.github.io/REPO_NAME/ Note: Pages takes 1-2 minutes to go live. Error Handling Repo already exists: Suggest appending a number ( my-slides-2 ) or a date ( my-slides-2026 ). Pages enablement fails: Still return the repo URL. User can enable Pages manually in repo Settings. PPTX conversion fails: Tell user to run pip install python-pptx . PDF conversion fails: Suggest installing poppler-utils ( apt install poppler-utils or brew install poppler ). Google Slides download fails: The presentation may not be publicly accessible. Ask user to make it viewable or download the PPTX manually.