How do I install the Publish To Pages skill?

Run npx skillmds add williamlimasilva/publish-to-pages in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Publish To Pages safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Publish To Pages?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Publish To Pages free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Publish To Pages?

williamlimasilva (@williamlimasilva) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Publish To Pages by williamlimasilva

Name: Publish To Pages
Rating: 4.2 (5 reviews)
Author: williamlimasilva

Publish To Pages

Publish presentations and web content to GitHub Pages. Converts PPTX, PDF, HTML, or Google Slides to a live GitHub Pages URL. Handles repo creation, file conversion, Pages enablement, and returns the live URL. Use when the user wants to publish, deploy, or share a presentation or HTML file via GitHub Pages.

williamlimasilva a13a128 4 files · 19.8 KB Updated Sep 10, 2026

File contents

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.

---name: publish-to-pagesdescription: Publish presentations and web content to GitHub Pages. Converts PPTX, PDF, HTML, or Google Slides to a live GitHub Pages URL. Handles repo creation, file conversion, Pages enablement, and returns the live URL. Use when the user wants to publish, deploy, or share a presentation or HTML file via GitHub Pages.---# publish-to-pagesPublish any presentation or web content to GitHub Pages in one shot.## 1. Prerequisites CheckRun these silently. Only surface errors:```bashcommand -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 DetectionDetermine 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### HTMLNo conversion needed. Use the file directly as `index.html`.### PPTXRun the conversion script:```bashpython3 SKILL_DIR/scripts/convert-pptx.py INPUT_FILE /tmp/output.html```If `python-pptx` is missing, tell the user: `pip install python-pptx`### PDFConvert with the included script (requires `poppler-utils` for `pdftoppm`):```bashpython3 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 Slides1. Extract the presentation ID from the URL (the long string between `/d/` and `/`)2. Download as PPTX:```bashcurl -L "https://docs.google.com/presentation/d/PRESENTATION_ID/export/pptx" -o /tmp/slides.pptx```3. Then convert the PPTX using the convert script above.## 4. Publishing### VisibilityRepos 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```bashbash 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. OutputTell 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.

Frequently asked questions