protowiki-deploy

Automate ProtoWiki deployment to GitHub Pages with PR previews and base-path handling.

7|6|Updated Apr 28, 2026
One-click install
npx skills add https://github.com/wikimedia/ProtoWiki --skill protowiki-deploy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: protowiki-deploy
Source: https://github.com/wikimedia/ProtoWiki/tree/main/.agents/skills/protowiki-deploy
Command: npx skills add https://github.com/wikimedia/ProtoWiki --skill protowiki-deploy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ProtoWiki deployment to GitHub Pages can be complex: coordinating production deploys, PR previews, and base-path handling across template repos and copied forks, while ensuring a reliable SPA fallback and CI workflow integration.

Core Features & Use Cases

  • Production deploys to the gh-pages branch with proper base-path handling and SPA fallback behavior.
  • PR preview deployments that generate isolated previews for in-progress changes without affecting main.
  • Template-first repo setup guidance to quickly start prototyping from the ProtoWiki template.
  • Base-path configuration using PROTOWIKI_BASE to ensure correct routing in different environments.
  • CI workflow integration to automate builds, previews, and deployment, reducing manual steps.

Quick Start

Run the deployment workflow by pushing to main or opening a PR to trigger CI-based production and preview deployments.

Frequently Asked Questions about protowiki-deploy

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

FAQPage Schema
How do I deploy a SPA to GitHub Pages with correct base-path routing?

Deploy a SPA to GitHub Pages by configuring the base-path variable PROTOWIKI_BASE and integrating CI workflows, ensuring correct routing and SPA 404 fallback behavior across different environments. This automation handles template-first repos and copied forks seamlessly.

How do I set up PR preview deployments for GitHub Pages without affecting production?

Set up PR preview deployments by triggering CI workflows when opening a pull request, which generates isolated previews for in-progress changes. The ProtoWiki deployment automation keeps these previews aligned with production without affecting the main branch.

Why does my SPA 404 fallback fail on GitHub Pages after deployment?

SPA 404 fallback failures on GitHub Pages often stem from incorrect base-path configuration. Setting the PROTOWIKI_BASE variable correctly within your CI workflow coordinates the fallback behavior, ensuring reliable routing for deployed single-page applications.

Can I use a template-first repo setup to automate GitHub Pages CI workflows?

Yes, you can use a template-first repo setup to quickly start prototyping from the ProtoWiki template. This approach automates builds, previews, and production deployments via GitHub Actions, reducing manual CI workflow configuration steps.

How do I configure PROTOWIKI_BASE for copied forks and template repos?

Configure PROTOWIKI_BASE in copied forks and template repos by applying base-path handling within your CI workflow integration. This ensures correct routing in different environments, keeping production deploys and PR previews aligned and reproducible.

What's the best way to automate ProtoWiki deployment to GitHub Pages?

The best way to automate ProtoWiki deployment to GitHub Pages is by integrating GitHub Actions CI workflows. This approach coordinates production deploys to the gh-pages branch, PR previews, and base-path handling to deliver consistent, reproducible deployments.