create-weekly-event

name	create-weekly-event
description	End-to-end creation of a weekly AI Breakfast event — creates the listing on huodongxing, generates all assets (QR, posters, banner), and finalizes the event. Use when setting up the next AI Breakfast event.
argument-hint	[event number, date, and theme, e.g. '#39 Mar 20 theme: LLM tools']
user-invocable	true
allowed-tools	["Bash","Read","Write","Glob","Grep"]

Create Weekly AI Breakfast Event

Orchestrates the full end-to-end flow for setting up a new AI Breakfast event. The order matters due to a critical huodongxing server bug (see warning below).

Phase Order

1. Create skeleton event on huodongxing (huodongxing-create-event) — just title, date, ticket type
2. Draft poster + banner HTML and render banner / poster-without-QR — use the wait time productively
3. Download QR code (huodongxing-qr) — only after ~10 min have passed since event creation
4. Re-render poster with QR (generate-posters) — now that the QR is available
5. Finalize event on huodongxing — upload banner, poster, description
6. Update the website front page — app/page.tsx displays the next meetup, so it has to be touched every week

Read each sub-skill's SKILL.md for detailed instructions. This skill provides the overall flow and timing.

---

CRITICAL: Huodongxing QR Code Bug

After creating a new event, you MUST wait ~10 minutes before downloading the QR code.

Huodongxing's server needs time to generate the WeChat mini-program QR code after event creation. If you request the QR code too soon:

• It triggers a server-side bug
• The QR code becomes permanently unavailable for that event
• There is no fix — the event's QR is broken forever

Strategy: Create the event skeleton first, then do other work (start dev server, prepare poster params, edit event details) while the server catches up. Download QR only after sufficient time has passed.

---

Inputs Needed

Before starting, confirm with the organizer:

• Event number — check the most recent event folder in events/ to determine the next number
• Date — AI Breakfast is typically on Thursdays
• Theme/tagline — what topics or format this week

For defaults (time, venue, location, capacity), check .claude/skills/PREFERENCES.md in the project root. These occasionally change.

---

Phase 1: Create Skeleton Event on Huodongxing

Skill: huodongxing-create-event

Goal: Get the event created ASAP so the QR code generation clock starts ticking.

# Open browser in headed mode for login
agent-browser --headed open https://www.huodongxing.com/login
# Wait for the organizer to log in (WeChat QR or SMS)

# Navigate to create page
agent-browser open https://www.huodongxing.com/createv3#/

Fill the minimum required fields to submit:

1. Title: "AI Breakfast #NUM"
2. Date and time (start: 09:00, end: 10:30)
3. Ticket type: 免费票, 25 attendees (required or submission fails)
4. Accept agreement checkbox
5. Submit

Don't bother with banner, location, description, or highlights yet — we'll add those in Phase 5. The goal is just to get the event created so the server starts generating the QR code.

After submission, note the event ID from the listings page (https://www.huodongxing.com/console/eventadmin). You'll need it for the QR download.

Record the time when the event was created. You need to wait ~10 minutes from this point.

---

Phase 2: Draft Posters + Continue Editing

While waiting for the QR code to become available, use the time productively:

2a. Create the event folder and copy templates

ROOT="${AI_BREAKFAST_ROOT:-$PWD}"
EVENT_NUM=XX
PREV_NUM=$((EVENT_NUM - 1))
SRC="$ROOT/events/2026/ai-breakfast-${PREV_NUM}"
DST="$ROOT/events/2026/ai-breakfast-${EVENT_NUM}"
mkdir -p "$DST"/images/{graphics,qr-codes,speakers}
cp "$SRC"/poster.html "$SRC"/poster-qr.html "$SRC"/banner.html "$DST/"
# Also create event.md (see _templates) — date, time, venue, speaker, demo title/blurb

2b. Edit the three HTML files for this week's content

Hand-author against the brand system. See the generate-posters skill for layout anatomy and which fields to change. Avatar and QR placeholders stay in until the real assets arrive.

2c. Render banner + poster (no QR) to PNG

Use the generate-posters skill's render commands. Skip poster-qr.html for now — you'll re-render it in Phase 4 once the QR is downloaded.

2d. Go back to huodongxing and fill in remaining event details

While still waiting for QR, navigate to the event edit page and fill in:

• Location: 上海 > 静安, full address
• 活动亮点 (150 char max, bilingual)
• 活动详情 (TinyMCE — insert poster-no-qr image + text description)
• Upload banner to the banner slot

Follow the huodongxing-create-event skill for all Element UI quirks and TinyMCE instructions.

---

Phase 3: Download QR Code

Skill: huodongxing-qr

Only proceed once ~10 minutes have passed since event creation in Phase 1.

First, determine the CDN date prefix. For newly created events, check the promote page:

# Navigate to event's promote page
agent-browser open "https://www.huodongxing.com/myevent/promote?id=EVENT_ID&tab=0"
# Check for new tabs!
agent-browser tab

# Find the QR code image URL to extract the YYYYMM prefix
agent-browser eval "Array.from(document.querySelectorAll('img')).filter(i => i.alt === '小程序二维码').map(i => i.src)"

Then download:

curl -sf -H "Referer: https://www.huodongxing.com/" \
  -o "$DST/images/qr-codes/wechat-mini-program.png" \
  "https://cdn.huodongxing.com/logo/YYYYMM/EVENT_ID/promoteMini.png"

# VERIFY before proceeding — this is critical
file "$DST/images/qr-codes/wechat-mini-program.png"
# MUST show: PNG image data, 400 x 400, 8-bit/color RGBA
# If it shows 1KB or HTML, the QR isn't ready yet — wait longer and retry

If the file is ~1KB or doesn't open as an image, STOP. Wait a few more minutes and try again. Do NOT keep retrying rapidly — that may trigger the permanent bug.

---

Phase 4: Render Poster WITH QR

Skill: generate-posters

Now that images/qr-codes/wechat-mini-program.png exists, swap the QR placeholder in poster-qr.html for an <img> tag pointing at it, then re-render to images/graphics/poster-with-qr.png. The render is purely local — agent-browser loads the HTML as a file:// URL, so no dev server or public hosting is needed.

---

Phase 5: Finalize & Verify

5a. Verify all images

file "${DEST}"/*.png
# banner: PNG image data, 1080 x 640
# posters: PNG image data, 1080 x 1920

open "${DEST}"/*.png  # Visual check

5b. Confirm event on huodongxing

agent-browser open https://www.huodongxing.com/console/eventadmin
agent-browser screenshot /tmp/hdx-verify.png

Event should appear in the listings with all details filled in.

---

Phase 6: Update Website Front Page

app/page.tsx displays the upcoming meetup. This must be updated every week — the date, topic blurb, and (if relevant) agenda times are all hardcoded in the JSX. Skipping this leaves the site advertising a past event.

Open app/page.tsx and update these fields against the new event.md:

What	Where	Source
Topic blurb	<p> under the <h1> — This week: <strong>…</strong> — …	event.md "This Week's Demo"
Next meetup date	The "Next meetup" <aside> — Thu MMM DD | H–Ham format	event.md Date + Time
Agenda times (if changed)	The "What to expect" <ul> — currently 8:00–8:30 intros, 8:30+ demos	.claude/skills/PREFERENCES.md

After editing, eyeball the page (bun dev then open http://localhost:3000) before declaring done.

If the front page ever gets refactored to read from event.md directly, this phase can drop to "verify the most recent event.md is picked up." Until then, treat this as required manual work.

---

Output Checklist

• event.md populated for ai-breakfast-NUM
• Event created on huodongxing (with banner, description, location, ticket type)
• QR code: events/2026/ai-breakfast-NUM/images/qr-codes/wechat-mini-program.png
• Banner: events/2026/ai-breakfast-NUM/images/graphics/banner-1080x640.png
• Poster (no QR): events/2026/ai-breakfast-NUM/images/graphics/poster.png
• Poster (with QR): events/2026/ai-breakfast-NUM/images/graphics/poster-with-qr.png
• Speaker photo dropped into images/speakers/ and posters re-rendered
• Share poster-with-qr.png with the organizer for WeChat/social distribution
• Front page (app/page.tsx) updated with new date, topic blurb, and agenda times (Phase 6)

Notes

• The poster-with-qr is the primary asset the organizer shares on WeChat Moments and group chats.
• The poster (no QR) goes into huodongxing's 活动详情 section (huodongxing adds its own QR).
• The banner goes into huodongxing's banner/header slot (1080x640).
• If events were pre-created via the WeChat miniprogram, skip Phase 1 but still respect the QR timing — check when the event was created before downloading.
• The event-poster-website Next.js app is no longer used for poster generation. Posters are hand-authored HTML rendered via agent-browser. See generate-posters for details.