How do I install the Deploy Gh Pages skill?

Run npx skillmds@latest add tomevault-io/deploy-gh-pages in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Deploy Gh Pages skill do?

Deploying the Astro site to GitHub Pages, fixing deployment issues, and configuring the CI/CD pipeline. Use when this capability is needed. It is listed under Web & Frontend on SkillMD.

Is Deploy Gh Pages safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Deploy Gh Pages?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Deploy Gh Pages free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Deploy Gh Pages?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Deploy Gh Pages by tomevault-io — Agent Skill

Name: Deploy Gh Pages
Author: tomevault-io

File contents

Deploy to GitHub Pages

How It Works

Push to main triggers the GitHub Actions workflow at .github/workflows/deploy.yml. It builds the Astro site and deploys to GitHub Pages automatically.

Pipeline Steps

Checkout code
Build using withastro/action@v2 (installs deps, runs astro build)
Deploy to GitHub Pages via actions/deploy-pages@v4

Configuration Checklist

Setting	Value	File
`site`	`https://sami.github.io`	`astro.config.mjs`
`base`	`/selco`	`astro.config.mjs`
`.nojekyll`	Present in repo root	Prevents Jekyll processing
Branch	`main`	Workflow trigger

Common Issues

Links return 404 on GitHub Pages

All internal links must use import.meta.env.BASE_URL prefix. The base is /selco, not /.

CSS/assets not loading

Astro handles asset paths automatically when base is configured. Do not manually prefix static asset paths.

Build fails in CI

Run npm run build locally first. The CI environment uses the same build command.

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

Frequently asked questions

Deploy Gh Pages