--- name: meeting-agenda description: "Turn a meeting agenda into a self-contained HTML slide deck with a countdown timer per item: one slide per item (large 01, 02… number, title, optional sub-points), a ring timer that turns amber in the last 20% and red with a +M:SS count-up past zero, a footer with clickable progress dots and a per-item meeting progress bar, and a built-in editor (gear button) that saves to localStorage or downloads an updated copy. Use when the user invokes /meeting-agenda, or asks for agenda slides, a timed agenda, a meeting timer deck, or to present an agenda with timeboxes. Accepts pasted agenda text, notes, a document, or agenda JSON. Delivers one offline HTML file that needs no dependencies." license: MIT compatibility: "Python 3.9+ (stdlib only) to build the deck; any modern browser to present it; optional pytest + Playwright to run the bundled test suite" disable-model-invocation: true metadata: name: meeting-agenda type: skill author: sugatoray version: "1.0.0" source_url: "https://github.com/sugatoray/aiskills/tree/master/skills/productivity/meeting-agenda" --- # Meeting agenda Build a timed slide deck from an agenda by filling the bundled template, then hand over one working HTML file. Never hand-edit the template for a single deck; the build script writes the agenda into it safely. Leave `README.md`, `CHANGELOG.md` and `meta/` for maintainers. Read `meta/MAINTAINERS.md` only when changing the template itself. ## Invocation `/meeting-agenda [[agenda text, notes, or a path to a file]]` with these options: | Option | Default | Contract | | --- | --- | --- | | `--title` | Inferred from the request, else none | Meeting name shown top-left and as the page title. | | `--total` | Sum of item minutes | Target length in minutes. Use it to allocate missing item times (below). If items already carry minutes that don't add up to it, say so; don't silently rescale. | | `--theme` | `aurora` | Studio themes: `aurora` (default), `observatory` (black, mono, watch-dial timer), `abyss` (deep teal), `editorial` (light, serif; for bright rooms and projectors) `signal` (black, white, yellow; high contrast), `clarity` (light, calm, Apple-style; the timer on a raised card) or `clarity-dark` (the same in true black). Classic themes: `indigo`, `midnight`, `ocean`, `daylight` or `contrast`. If the user mentions a bright room or a projector, suggest `clarity`, `editorial` or `daylight`; for accessibility, `signal` or `contrast`. | | `--output` | `meeting-agenda.html` in the working directory | Path of the HTML file to write. | | `--demo` | Off | Return the bundled 30-minute demo deck exactly as it ships. See **Demo** below. | With no agenda at all, ask for one. If the user asks for a demo or an example, treat it as `--demo`. ## Demo (`--demo`) Copy the bundled deck byte for byte. Don't build, edit or re-theme it: ```bash python3 scripts/build_deck.py --demo -o meeting-agenda.html ``` The script refuses an agenda, `--title` or `--theme` alongside `--demo` (exit 2). If the user passed any, say they were ignored, and offer a custom build instead. Then skip to **4. Deliver**: send the file, show the demo's five items (10 + 8 + 5 + 3 + 4 = 30 minutes), and give the controls line. ## 1. Turn the input into agenda JSON ```json { "title": "Team Planning Meeting", "theme": "aurora", "items": [ { "minutes": 10, "title": "Priorities for 2026 & 2027", "points": ["What are the priorities for 2026?", "What are the priorities for 2027?"] } ] } ``` - **One item per agenda topic, in the user's order.** Use the user's wording for titles. Keep each title short (about 8 words or fewer) and move the detail into `points`. - **`points`** holds the sub-items, one string each. Omit it, or use `[]`, when an item has none. Don't invent points; if the user gave none, there are none. - **`minutes`** must be > 0; 0.5 steps are typical (`7.5` shows as 7:30). - Times given for every item: use them as given. - Times given for some items plus a `--total`: spread the remaining minutes across the untimed items, rounded to 0.5. State the times you chose. - No times anywhere: ask. If the user wants you to decide, propose times and say so in the summary. - Don't add items the user didn't list (no surprise "Intro" or "AOB"). You may suggest them in your reply. ## 2. Build the deck Write the JSON to a temporary file, then run the script from this skill's directory: ```bash python3 scripts/build_deck.py agenda.json -o meeting-agenda.html --title "Team Planning Meeting" --theme aurora ``` - `-` reads the JSON from stdin, and `--check` validates without writing. - **Exit 2 means invalid input.** The error names the item and the problem (`item 3: title is required`). Fix the JSON and run it again. - The script copies `assets/meeting-agenda.html` and replaces only its `` are safe. It prints `wrote : N items, M:SS planned`. ## 3. Verify - Check that the printed item count and planned total match what you intended. - If a browser tool or Playwright is available, open the file and check that the first slide shows `01` and your first title, and that the footer reads `Meeting: 0:00 used / planned`. - Run the bundled suite (`python3 -m pytest` in this directory) only if you changed the template or the script. ## 4. Deliver Give the user: 1. The HTML file (send it or link it; don't paste its source). 2. A short table of the items (number, minutes, title) and the planned total. Point out any times you chose for them. 3. The controls in one or two lines. Keyboard: `→`/`PgDn` next, `←`/`PgUp` back, `Home`/`End`, `Space` or `P` pause/resume, `R` reset. Phone: swipe or tap (right side forward, left side back), hold to pause, `‹ ›` buttons. The gear edits the agenda: Apply remembers it in that browser, and Save HTML downloads an updated copy. ## What the deck does (for answering questions) - **Slides:** one per item, with a large two-digit number, the title, and the sub-points. Above the number, a cyan label reads "Agenda item 3 of 5 · 5 min". The default theme, Aurora, has a slowly drifting violet aurora, a glass dial and a "live" label; eleven other themes are a click away. Adapts to any number of items and any lengths. The "Agenda item N of M" line stays at the same height on every slide, so switching slides doesn't make the text jump. - **Timers:** each slide has a violet-to-cyan ring countdown, captioned "of M:SS allotted",, that starts when the slide is shown and pauses when you leave it. It turns amber in the last 20% of the item's time, then red, pulsing and counting up (`+M:SS`) past zero. `Space` or `P` pauses/resumes (like a video player), and `R` resets; the buttons do the same. - **Footer:** keyboard hints, clickable progress dashes (one per item, each filling with that item's time), a progress bar, then `Meeting: M:SS used / M:SS planned`. The bar has one section per item, each filling with the time spent on that item. The bar turns amber at 80% of the planned total and red past it, and its tooltip shows the percentage used. - **Phones and tablets:** swipe left/right for next/previous, tap the right 70% / left 30% of the slide, long-press (½ s) to pause or resume, and `‹ ›` buttons beside the progress dashes. Touch targets are at least 44 px, and the layout scales down to fit a phone. Mouse clicks on the slide don't navigate. - **Settings (gear):** two tabs. - **Contents:** the deck title (shown top-left and as the page title; may be blank), a running total, and two views of the same draft. **Quick View** (default) is one list with inline title, sub-points and minutes, and ↑ ↓ ✕ on hover or focus. **Detailed View** has the item list on the left and the selected item on the right, with a −/+ minutes control, 5/10/15/30 quick picks and one line per sub-point. The last item can't be removed. - **Theme:** twelve themes as preview cards: seven studio themes (Aurora, Observatory, Abyss, Editorial, Signal, Clarity, Clarity Dark), then the five classics (Indigo, Midnight, Ocean, Daylight, High contrast). Clicking one previews it live. - **Shared buttons:** Reset to defaults (asks first), Cancel/Esc/× (discard changes, including a previewed theme), Save HTML (the agenda and theme go into the copy), and Apply or Ctrl/⌘+Enter (saved in the browser). - Items without a title or with minutes ≤ 0 get a red edge and a short message, the footer counts them, and they block Apply and Save. While Settings is open the timer pauses and keys don't change slides. - **Offline and private:** no network requests, and agenda text is never parsed as HTML. See `meta/SECURITY.md`.