GitHub Pages 一键部署指南：使用 GitHub CLI 快速部署静态网站

gh-pages-deploy by aviz85/claude-skills-library

171 周安装量

21 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/aviz85/claude-skills-library --skill gh-pages-deploy

开发自动化开发运维

🇨🇳中文介绍

GitHub Pages 部署

使用 GitHub CLI 将静态前端网站部署到 GitHub Pages。

前提条件

已安装并完成身份验证的 GitHub CLI (gh)
已安装 Git
一个准备就绪、可以部署的前端项目（HTML、CSS、JS）

部署流程

1. 初始化 Git 仓库（如果需要）

git init
git add .
git commit -m "Initial commit"

2. 创建 GitHub 仓库

# 创建公开仓库（免费 GitHub Pages 所必需）
gh repo create <repo-name> --public --source=. --push

3. 启用 GitHub Pages

# 从 main 分支根目录启用 GitHub Pages
gh api repos/{owner}/{repo}/pages -X POST -f build_type=legacy -f source='{"branch":"main","path":"/"}'

或者针对 docs 文件夹：

gh api repos/{owner}/{repo}/pages -X POST -f build_type=legacy -f source='{"branch":"main","path":"/docs"}'

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

4. 检查部署状态

# 获取页面信息
gh api repos/{owner}/{repo}/pages

# 查看部署状态
gh api repos/{owner}/{repo}/pages/builds/latest

站点将可通过以下地址访问：https://<username>.github.io/<repo-name>/

一键完成整个部署流程：

# 变量
REPO_NAME="my-site"

# 初始化和提交
git init
git add .
git commit -m "Initial commit"

# 创建仓库并推送
gh repo create $REPO_NAME --public --source=. --push

# 等待推送完成，然后启用 Pages
sleep 2
OWNER=$(gh api user --jq '.login')
gh api repos/$OWNER/$REPO_NAME/pages -X POST -f build_type=legacy -f source='{"branch":"main","path":"/"}'

# 获取 URL
echo "Site will be at: https://$OWNER.github.io/$REPO_NAME/"

Pages 未启用：确保仓库是公开的，或者您拥有 GitHub Pro
404 错误：等待 1-2 分钟让部署完成，检查根目录下是否存在 index.html
构建失败：检查 GitHub Actions 选项卡以查找错误

git add .
git commit -m "Update site"
git push

GitHub Pages 将自动重新构建。

🇺🇸English

GitHub Pages Deployment

Deploy static frontend websites to GitHub Pages using the GitHub CLI.

Prerequisites

GitHub CLI (gh) installed and authenticated
Git installed
A frontend project (HTML, CSS, JS) ready to deploy

Deployment Workflow

1. Initialize Git Repository (if needed)

git init
git add .
git commit -m "Initial commit"

2. Create GitHub Repository

# Create public repo (required for free GitHub Pages)
gh repo create <repo-name> --public --source=. --push

3. Enable GitHub Pages

# Enable GitHub Pages from main branch root
gh api repos/{owner}/{repo}/pages -X POST -f build_type=legacy -f source='{"branch":"main","path":"/"}'

Or for docs folder:

gh api repos/{owner}/{repo}/pages -X POST -f build_type=legacy -f source='{"branch":"main","path":"/docs"}'

4. Check Deployment Status

# Get pages info
gh api repos/{owner}/{repo}/pages

# View deployment status
gh api repos/{owner}/{repo}/pages/builds/latest

5. Get Site URL

The site will be available at: https://<username>.github.io/<repo-name>/

Quick Deploy Script

For a complete deployment in one flow:

# Variables
REPO_NAME="my-site"

# Initialize and commit
git init
git add .
git commit -m "Initial commit"

# Create repo and push
gh repo create $REPO_NAME --public --source=. --push

# Wait for push to complete, then enable pages
sleep 2
OWNER=$(gh api user --jq '.login')
gh api repos/$OWNER/$REPO_NAME/pages -X POST -f build_type=legacy -f source='{"branch":"main","path":"/"}'

# Get the URL
echo "Site will be at: https://$OWNER.github.io/$REPO_NAME/"

Troubleshooting

Pages not enabled : Ensure repo is public or you have GitHub Pro
404 error : Wait 1-2 minutes for deployment, check if index.html exists at root
Build failed : Check GitHub Actions tab for errors

Updating the Site

After making changes:

git add .
git commit -m "Update site"
git push

GitHub Pages will automatically rebuild.

Weekly Installs

126

Repository

aviz85/claude-s…-library

GitHub Stars

First Seen

Jan 20, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

opencode115

codex113

gemini-cli113

cursor103

github-copilot103

claude-code103

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

152,900 周安装