web-deploy-github

name	web-deploy-github
description	Create and deploy single-page static websites to GitHub Pages with autonomous workflow. Use when building portfolio sites, CV pages, landing pages, or any static web project that needs GitHub Pages deployment. Handles complete workflow from project initialization to live deployment with GitHub Actions automation.

Web Deploy GitHub Pages

Overview

This skill enables autonomous creation and deployment of static websites to GitHub Pages. It follows a complete workflow from project structure initialization through automatic deployment via GitHub Actions, optimized for single-page applications, portfolios, and landing pages.

Core Workflow

1. Project Initialization

Create the project structure:

bash scripts/init_project.sh <project-name>

This creates:

project-name/
├── index.html
├── styles.css
├── script.js
├── README.md
└── .github/
    └── workflows/
        └── deploy.yml

2. Development

Build the website following these principles:

• Single-page first: Optimize for one-page layouts unless multiple pages explicitly required
• Autonomous generation: Generate complete, production-ready code without placeholders
• Modern design: Use modern CSS (flexbox, grid), responsive design, clean aesthetics
• No dependencies: Pure HTML/CSS/JS when possible, CDN links if frameworks needed

Use templates from assets/templates/ as starting points:

• base-html/ - Minimal HTML5 boilerplate
• portfolio/ - Portfolio/CV template with sections
• landing/ - Landing page with hero and CTA

3. GitHub Repository Setup