mofa-publish

Deploy built static sites to GitHub Pages or Mac Mini hosting.

11|12|Updated Feb 28, 2026
One-click install
npx skills add https://github.com/mofa-org/mofa-skills --skill mofa-publish
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mofa-publish
Source: https://github.com/mofa-org/mofa-skills/tree/main/mofa-publish
Command: npx skills add https://github.com/mofa-org/mofa-skills --skill mofa-publish

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, git, curl, ssh, scp, sshpass, and includes scripts (resource) components.

What problem does it solve?

Deploys built static sites to GitHub Pages or Mac Mini hosting, removing manual steps like repo creation, branch setup, Pages configuration, and file transfer.

Core Features & Use Cases

  • End-to-end deployment workflow for static sites to public Pages and private Mac Mini hosts.
  • Generates a GitHub Pages workflow (optional) and verifies live URLs after deploy.
  • Supports common built-site outputs (docs, dist, out) and plain HTML, enabling deterministic, repeatable deployments.

Quick Start

Publish your built site to GitHub Pages or a Mac Mini host using the publish_site.sh helper.

Frequently Asked Questions about mofa-publish

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

FAQPage Schema
How do I automate static site deployment to GitHub Pages and Mac Mini?

Automate static site deployment by running a deterministic publish_site.sh script that orchestrates repo creation, Pages setup, file transfer via scp, and live URL verification for Quarto, Astro, or Next.js outputs.

What do I need to deploy a built static site to GitHub Pages using a script?

Deploying a built static site requires the gh, git, curl, ssh, and scp binaries installed, along with site_dir, slug, and repo inputs to automate file transfer and Pages configuration without manual steps.

Can I publish Quarto or Astro outputs to a private Mac Mini host?

Yes, you can publish Quarto, Astro, or Next.js static outputs to a private Mac Mini host by providing the site directory and using ssh and scp for automated file transfer and URL verification.

Does the deployment workflow support plain HTML and common build output directories?

The deployment workflow supports common built-site output directories including docs, dist, out, and plain HTML, enabling deterministic and repeatable deployments to public GitHub Pages or private Mac Mini hosts.

What is the best way to remove manual GitHub Pages configuration and repo setup?

Remove manual GitHub Pages configuration and repo setup by using an automated deployment workflow that generates a Pages workflow, creates the repository, configures branches, and verifies the live URL after deploy.

Why does my static site deploy fail when transferring files to Mac Mini?

Static site deploys to Mac Mini fail if ssh, scp, or sshpass binaries are missing, or if the site_dir, slug, and repo inputs are incorrect, disrupting the detect, prepare, deploy, and verify orchestration steps.