Bob GitHub Pages Lab

This repository accompanies a hands-on article that turns committed Markdown into a static GitHub Pages site with IBM Bob Shell v2 and TasteSkill.

The source of truth lives under content/. A GitHub Actions workflow asks Bob to generate _site/, validates the result, uploads it as a Pages artifact, and deploys it. Generated HTML is never committed.

Repository Layout

• article.md contains the complete tutorial
• content/ contains the site brief and Markdown posts
• .github/skills/ contains the pinned design skill and the publishing contract
• .github/actions/bob-action/ runs Bob Shell v2 without giving it a GitHub token
• .github/workflows/pages.yml generates and deploys the site
• scripts/validate-site.py checks the artifact boundary and generated links

Local Validation

Bob creates _site/ in GitHub Actions. After a run, download the Pages artifact and validate it locally:

python3 scripts/validate-site.py

The article explains the required GitHub secrets, Pages configuration, and full workflow.