name	deploy
description	Deploy the reading tracker to GitHub Pages. Use this skill whenever the user says 'deploy', '发布', '部署', 'push to gh-pages', 'trigger workflow', '更新网站', or any variation of wanting to get the latest reading tracker live on the site. Covers both remote GitHub Actions trigger and local build+push.

Deploy Reading Tracker

Two deployment methods are available. Ask the user which one they prefer, or pick based on context:

Method 1: Remote Trigger (GitHub Actions)

Preferred when: the user just wants to refresh the live site, no local code changes involved.

Prerequisites: gh CLI must be installed and authenticated.

Steps:

Run gh workflow run deploy.yml --repo Nickilism/reading-tracker to trigger the workflow
Confirm the workflow was dispatched: gh run list --workflow=deploy.yml --repo Nickilism/reading-tracker --limit=1
Tell the user the workflow is running and they can watch it at https://github.com/Nickilism/reading-tracker/actions

Method 2: Local Build + Push

Preferred when: the user has made local changes to template.js, reading-tracker-github.js, or other code and wants to deploy them immediately (without waiting for a PR/merge).

Prerequisites: Node.js installed, AIRTABLE_API_KEY environment variable set (loaded from .env via dotenv).

Steps:

Run node reading-tracker-github.js in the project root to generate the HTML
Verify the output file was created (e.g., 2026_reading_tracker.html)
Force-push the generated HTML to gh-pages:
```
git checkout gh-pages
git add -f *_reading_tracker.html
git commit -m "deploy: update reading tracker"
git push origin gh-pages
git checkout main
```
If the gh-pages branch doesn't exist locally yet, create it from remote first: git fetch origin gh-pages:gh-pages

Decision Guide

Situation	Use
User says "deploy" without more context	Ask: remote trigger or local build?
User changed code locally	Local build + push
User just wants to refresh data from Airtable	Remote trigger
User says "发布" / "部署" / "更新网站"	Ask which method

Deploy Reading Tracker

Two deployment methods are available. Ask the user which one they prefer, or pick based on context:

Method 1: Remote Trigger (GitHub Actions)

Preferred when: the user just wants to refresh the live site, no local code changes involved.

Prerequisites: gh CLI must be installed and authenticated.

Steps:

Run gh workflow run deploy.yml --repo Nickilism/reading-tracker to trigger the workflow

Confirm the workflow was dispatched: gh run list --workflow=deploy.yml --repo Nickilism/reading-tracker --limit=1

Tell the user the workflow is running and they can watch it at https://github.com/Nickilism/reading-tracker/actions

Method 2: Local Build + Push

Preferred when: the user has made local changes to template.js, reading-tracker-github.js, or other code and wants to deploy them immediately (without waiting for a PR/merge).

Prerequisites: Node.js installed, AIRTABLE_API_KEY environment variable set (loaded from .env via dotenv).

Steps:

Run node reading-tracker-github.js in the project root to generate the HTML

Verify the output file was created (e.g., 2026_reading_tracker.html)

Force-push the generated HTML to gh-pages:

git checkout gh-pages
git add -f *_reading_tracker.html
git commit -m "deploy: update reading tracker"
git push origin gh-pages
git checkout main

If the gh-pages branch doesn't exist locally yet, create it from remote first: git fetch origin gh-pages:gh-pages

Decision Guide

Situation

Use

User says "deploy" without more context

Ask: remote trigger or local build?

User changed code locally

Local build + push

User just wants to refresh data from Airtable

Remote trigger

User says "发布" / "部署" / "更新网站"

Ask which method