p-meeting-prep

Meeting Prep

Setup

Locate this skill's directory (the folder containing this SKILL.md), then run the resolver script from there:

python <skill-dir>/scripts/skillctx-resolve.py resolve p-meeting-prep

The resolver outputs each binding as key: value (one per line). Substitute each {binding_key} placeholder below with the resolved value.

If any values are missing or the user requests changes, use:

python <skill-dir>/scripts/skillctx-resolve.py set p-meeting-prep <key> <value>

Generate per-meeting prep briefs for today's calendar (one markdown file per meeting + an index), writing to {output_dir}/YYYY-MM-DD/.

When to Use

• User says "meeting prep", "prep my meetings", "prep brief"
• User invokes /p-meeting-prep
• A scheduled cron / launchd job triggers /p-meeting-prep (typically early morning)

Prerequisites

• gws CLI installed and authenticated (Google Calendar)
• gh CLI authenticated (gh auth status)
• Slack MCP connected (optional — skip gracefully if unavailable)
• Fireflies MCP connected (optional — skip gracefully if unavailable)
• skillctx config initialized for p-meeting-prep

Arguments

• --date YYYY-MM-DD — Target date. Default: today.
• --lang ja|en — Output language. Default: {default_lang}.
• --dry-run — Print briefs to stdout instead of writing files.
• --no-open — Skip auto-opening the index after generation.

Workflow

Phase 1: Initialize

1. Parse arguments:
   • --date YYYY-MM-DD (default: today, local time)
   • --lang ja|en (default: {default_lang})
   • --dry-run (default: false)
   • --no-open (default: false)
2. Compute:
   • TARGET_DATE: the date to process, YYYY-MM-DD
   • WEEKDAY: short weekday name (e.g. Tue)
   • OUTPUT_DAY_DIR: {output_dir}/{TARGET_DATE} (expand ~ and env vars)
3. Confirm prerequisites:
   • gws is on PATH (command -v gws); if missing, fail with a clear error.
   • gh auth status succeeds; if not, fail with a clear error.
   • Slack MCP is reachable (one cheap call, e.g. slack_read_user_profile); if not, mark Slack as UNAVAILABLE and continue.
   • Fireflies MCP is reachable (one cheap call, e.g. fireflies_get_user); if not, mark Fireflies as UNAVAILABLE and continue.
4. Record availability flags as SOURCES_AVAILABLE = {calendar: bool, github: bool, slack: bool, fireflies: bool} for use in Phase 3.

Phase 2: Calendar fetch + classify

1. Fetch the day's events. → See references/agent-gather-calendar.md
2. Filter out junk:
   • Declined events (the user's response is declined).
   • All-day events.
   • Events with only one attendee = the user (focus blocks, holds).
3. Classify everything else in a single LLM call. → See references/agent-classify-meetings.md
4. Cluster meetings by topic_key. A cluster is any set of 2+ meetings sharing the same topic_key. Singletons are clusters of one and need no cross-links.
5. Save the classified list as MEETINGS = [{event, category, topic_key, cluster_id, …}] for Phase 3.

Phase 3: Parallel source fetch

First, read the attendee cache once — ~/.cache/p-meeting-prep/attendees.json (see references/attendee-cache.md) — and pass relevant entries to the GitHub and Slack fetches so cached attendees skip live resolution entirely.

For each meeting, pick the source set from this table:

Fan out all required fetches in parallel within a single tool-use batch where possible. Deduplicate by topic_key: a Fireflies or Slack topic search keyed off topic_key is run once per cluster, not once per meeting.

For each source, follow the corresponding reference:

• Fireflies → references/agent-gather-fireflies-meeting-context.md
• Slack → references/agent-gather-slack-meeting-context.md
• GitHub → references/agent-gather-github-attendee-context.md
• Web (candidate) → references/agent-gather-web-candidate-context.md

If a source's SOURCES_AVAILABLE flag is false (from Phase 1), skip every call to it and mark the corresponding sections as _(unavailable)_ later in Phase 4.

Each fetch has a soft budget of 15 seconds; on timeout, treat as unavailable for that meeting.

Save results as MEETING_CONTEXT[event_id] = {fireflies, slack_attendees, slack_topic, github, web_candidate}.

Phase 4: Synthesize briefs

For each meeting in MEETINGS:

1. Pick the template by category:
   • 1:1 → references/template-1on1.md
   • team-sync → references/template-team-sync.md
   • external → references/template-external.md
   • interview → references/template-interview.md
   • other → references/template-other.md
2. Render the template using MEETING_CONTEXT[event_id], in language {lang}.
3. If the meeting belongs to a cluster of size ≥ 2, add the Related today: line referencing the sibling filenames computed in Phase 5.
4. Empty data sections render as _(no relevant context found)_ rather than being omitted, so the user can tell the skill looked.

Store the rendered markdown per event as BRIEFS[event_id]. This completes Pass 1.

Pass 2 — cross-scan (after all briefs are drafted):

Filenames are deterministic from Phase 2 data (chronological order + start time + title slug) — compute them before Pass 2 so both cluster links and overlap links can reference sibling files.

1. Detect overlaps across the day's drafts:
   • (a) shared non-self attendees appearing in 2+ meetings;
   • (b) shared salient topics/entities — proper nouns, repo names, project names appearing in 2+ briefs' bodies (e.g. changelog-management).
2. For each overlap, inject into the header block of every affected brief: Related today: [<sibling file>](<sibling file>) — <shared attendee or topic, one short clause> Multiple siblings → comma-separated. Merge with any existing cluster-based Related today: line rather than duplicating it.
3. other-category meetings are excluded from the cross-scan (they have no body and no fetches).
4. Record the overlap list as OVERLAPS for the index (Phase 5).

Phase 5: Write files

1. Compute OUTPUT_DAY_DIR = {output_dir}/<TARGET_DATE> (expand ~).
2. If OUTPUT_DAY_DIR already exists:
   • Remove any existing <OUTPUT_DAY_DIR>.bak/.
   • mv the current OUTPUT_DAY_DIR to <OUTPUT_DAY_DIR>.bak/.
3. Create OUTPUT_DAY_DIR.
4. Compute filenames in chronological order:
   • NN = zero-padded sequence starting at 01 (the index uses 00).
   • HHMM = local start time, 24-hour, no colon.
   • <slug> = ASCII-folded, lowercase, hyphenated title; collapse runs of non-[a-z0-9] to a single -; trim to 40 chars; strip leading/trailing -.
   • If ASCII-folding leaves fewer than 4 useful characters (typical for Japanese titles), romanize instead: kanji/kana → romaji words, katakana loanwords → their English source word. Example: 採用：グッズブレストMTG → saiyo-goods-brainstorm-mtg. Same 40-char cap and collision rule.
   • Final name: NN-HHMM-<slug>.md.
5. Write 00-index.md first:

# Meeting prep — <TARGET_DATE> (<WEEKDAY>)
<N> meetings · <K> categories · <C> clusters

## Today
- HH:MM **<title>** `[category]` → [NN-HHMM-slug.md](NN-HHMM-slug.md)<` · cluster: <topic_key>` if cluster size ≥ 2>
... (one bullet per meeting, chronological)

## Clusters
- `<topic_key>` — <count> meetings (HH:MM, HH:MM, ...)
... (only clusters with size ≥ 2)

## Overlaps
- <shared attendee or topic> — <count> meetings (HH:MM, HH:MM, ...)
... (from Pass 2 cross-scan; omit the section when `OVERLAPS` is empty)

If N == 0, the index body is No meetings today. and no per-meeting files are written.

6. Write one file per meeting using BRIEFS[event_id].
7. Merge any live attendee resolutions from this run back into ~/.cache/p-meeting-prep/attendees.json (read-modify-write; see references/attendee-cache.md).
8. Print the absolute path to 00-index.md and a one-line summary (N meetings · K categories · C clusters).
9. On macOS (uname -s = Darwin), unless --no-open or --dry-run, run open "<00-index.md>".
10. If --dry-run, do NOT touch the filesystem at all. Instead, print to stdout: the index body, then each brief separated by ---.

Error Handling

Scheduling

This skill is user-triggered. Two recipes for running it automatically each morning are documented in references/cron-recipes.md. Whichever you pick, ensure the scheduled environment inherits credentials for gh, gws, the Slack MCP server, and the Fireflies MCP server.