| 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
- Create skeleton event on huodongxing (
huodongxing-create-event) — just title, date, ticket type
- Draft poster + banner HTML and render banner / poster-without-QR — use the wait time productively
- Download QR code (
huodongxing-qr) — only after ~10 min have passed since event creation
- Re-render poster with QR (
generate-posters) — now that the QR is available
- Finalize event on huodongxing — upload banner, poster, description
- 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.
agent-browser --headed open https://www.huodongxing.com/login
agent-browser open https://www.huodongxing.com/createv3#/
Fill the minimum required fields to submit:
- Title: "AI Breakfast #NUM"
- Date and time (start: 09:00, end: 10:30)
- Ticket type: 免费票, 25 attendees (required or submission fails)
- Accept agreement checkbox
- 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/"
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:
agent-browser open "https://www.huodongxing.com/myevent/promote?id=EVENT_ID&tab=0"
agent-browser tab
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"
file "$DST/images/qr-codes/wechat-mini-program.png"
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
open "${DEST}"/*.png
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
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.
