Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
DevOps & cloud

page

Deploy the built course wiki site/ to GitHub Pages via gh CLI. Pre-checks gh auth status and site/ existence.

WALKERKILLER · Static checks on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add WALKERKILLER/Look-Tongji-Notes --skill page

About this skill


name: page description: "Deploy the built course wiki site/ to GitHub Pages via gh CLI. Pre-checks gh auth status and site/ existence." license: MIT metadata: author: WALKERKILLER version: "1.1"

Page (GitHub Pages 部署)

将已构建的课程 wiki 静态站点部署到 GitHub Pages。

When to Use

  • User says /page or "deploy to pages" or "publish wiki".
  • After running /wiki build and the site/ directory is ready.

Workflow

1. 前置检查 A: gh CLI 已安装

gh --version

如未安装,输出安装指引,引导用户访问 https://cli.github.com/ 安装。

2. 前置检查 B: gh 已认证

gh auth status

如未认证,引导用户执行 gh auth login 完成 GitHub 认证。

3. 前置检查 C: site/ 已构建

检查 workspace 的 site/index.html 是否存在:

ls <WORKSPACE_ROOT>/site/index.html

如 site/ 不存在或为空,引导先运行 /wiki build 构建站点。

4. 确定部署目标 repo

优先使用环境变量 GH_PAGES_REPO:

echo $GH_PAGES_REPO

如果未设置,从当前 git remote 推断:

git remote get-url origin

用户可在 .env 中设置 GH_PAGES_REPO=owner/repo 来指定目标仓库。

5. 部署到 gh-pages 分支

gh pages deploy <WORKSPACE_ROOT>/site/ --repo <TARGET_REPO> --branch gh-pages

要求 gh CLI 版本 >= 2.29.0。

6. 输出结果

部署完成后,GitHub Pages URL 格式为 https://<owner>.github.io/<repo>/。

Requirements

  • gh CLI >= 2.29.0(安装: https://cli.github.com/)
  • 已完成 gh auth login
  • workspace 的 site/ 已通过 /wiki build 构建
  • 目标 GitHub repo 已启用 GitHub Pages

Where <SKILL_DIR> Points

<SKILL_DIR> is the directory containing this SKILL.md. The /page command uses the gh CLI directly (no shared Python scripts needed). For other skills, shared scripts (look_tongji.py, timeline_tools.py, tongji_backend/) and references live two levels up in the repository root (<SKILL_DIR>/../../scripts/ and <SKILL_DIR>/../../references/).