github-pages-deployment

Automate static site deployment to GitHub Pages via gh-pages and CI/CD workflows.

3|1|Updated Jun 3, 2025
One-click install
npx skills add https://github.com/Tobbe3108/GoPayShortcuts --skill github-pages-deployment
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-pages-deployment
Source: https://github.com/Tobbe3108/GoPayShortcuts/tree/main/.opencode/skills/github-pages-deployment
Command: npx skills add https://github.com/Tobbe3108/GoPayShortcuts --skill github-pages-deployment

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the deployment of static sites to GitHub Pages, reducing manual steps and ensuring consistent publishing with gh-pages, base path handling, domain routing, and CI/CD integration.

Core Features & Use Cases

  • gh-pages automation: publish build outputs to the gh-pages branch.
  • Base path and domain handling: manage project sites under a subpath and configure custom domains (CNAME).
  • CI/CD workflows: provide GitHub Actions patterns to build and deploy on git events.
  • Multi-environment deployment: support different base paths or environments via environment variables.

Quick Start

Push changes to the repository configured for GitHub Pages deployment to trigger the CI/CD workflow that builds and publishes to gh-pages.

Frequently Asked Questions about github-pages-deployment

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

FAQPage Schema
How do I automate static site deployment to GitHub Pages using CI/CD?

Automate static site deployment to GitHub Pages by configuring a GitHub Actions workflow to build the project on git events and publish the output to the gh-pages branch using the gh-pages CLI. This ensures consistent publishing without manual steps.

How do I configure base paths for a SvelteKit project deployed to GitHub Pages?

Configure base paths in your SvelteKit project to manage project sites served under a subpath. The deployment process handles base path configuration via environment variables, ensuring assets load correctly when hosted on GitHub Pages.

Do I need the gh-pages CLI to publish my static site to the gh-pages branch?

Yes, the gh-pages CLI is required to publish build outputs to the gh-pages branch. You also need npm or yarn installed in your repository to run the build process and manage dependencies within your GitHub Actions workflow.

How do I support multi-environment deployment for my static site?

Support multi-environment deployment by using environment variables to define different base paths or configurations. This allows your CI/CD workflow to build and deploy your static site to distinct environments on GitHub Pages dynamically.