publish-chapter

Publishes a chapter's executed notebook, Colab twin, and explainer pages to GitHub Pages.

Updated Sep 13, 2026
One-click install
npx skills add https://github.com/shammun/fluidpy --skill publish-chapter-shammun
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: publish-chapter
Source: https://github.com/shammun/fluidpy/tree/main/.claude/skills/publish-chapter
Command: npx skills add https://github.com/shammun/fluidpy --skill publish-chapter-shammun

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Publishing a book chapter to a GitHub Pages site involves many error-prone manual steps: executing the notebook, generating the Colab twin, building the explainer web page, regenerating the site index and gallery, auditing the page, committing, pushing, and verifying live URLs. This Skill orchestrates that entire pipeline as one repeatable command. ## Core Features & Use Cases - Full chapter publishing: Runs the publish gate end to end — execute notebook, write the Colab twin and full-window explainer page, regenerate the index and gallery, audit in a browser, commit, push, and poll the live URLs for HTTP 200. - Site-only mode: /publish-chapter site regenerates just the index and explainer gallery, runs the public-repo check, commits, and pushes. - Safety controls: Supports --no-push for local-only commits, runs check_public.py before committing, and stops with instructions when no origin remote exists. - Use Case: After finishing Chapter 7's notebook and explainers, run /publish-chapter 7 to execute, build, audit, commit, push, and confirm the GitHub Pages URL is live. ## Quick Start Ask the assistant to publish chapter 7 of the fluidpy book to GitHub Pages and confirm the live page URL.

Frequently Asked Questions about publish-chapter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I publish a Jupyter notebook chapter to GitHub Pages?

Run /publish-chapter with the chapter number, for example /publish-chapter 7. It executes the notebook, writes the Colab twin and explainer page, regenerates the site index and gallery, commits, pushes, and polls the live URLs for a 200 response.

How do I regenerate only the site index and explainer gallery?

Use /publish-chapter site. This runs publish_notebook.py with --site-only, executes the public-repo check, commits with the message 'site: index and gallery', and pushes unless --no-push is given.

Can I commit a chapter publish without pushing to GitHub?

Yes, pass the --no-push flag, for example /publish-chapter 7 --no-push. The full local pipeline runs and the commit is created, but nothing is pushed to the remote.

What happens if the repository has no origin remote configured?

The publish stops after the local commit. The Skill prints the one-time remote-setup commands from GUIDE.md section 1.6 for the user to run manually with a leading exclamation mark.

How is a successful GitHub Pages deployment verified?

After pushing, the workflow polls the chapter page URL until it returns HTTP 200, then checks one explainer URL and the Colab notebook file URL. It prints the page, gallery, and Colab URLs plus the audit verdict.