Process all VTT meeting transcripts from meetings/incoming/ into structured markdown notes in meetings/.
Available scripts
scripts/parse-vtt.py— Parses raw VTT files into Markdown files with YAML frontmatter (date, attendees) and a cleanSpeaker: texttranscript (blank line between each turn). Supports--output-dirto control where.mdfiles are written.
Steps
- Find VTT files: Check both
meetings/incoming/and~/Downloads/for.vttfiles. Present each found file to the user with its modification/creation timestamp (usestatto get the time) so they can confirm which files to process. Typically only recently downloaded files (last few minutes/hours) are relevant. If none found in either location, tell the user and stop. - Parse VTT files: Run the bundled script on the confirmed files, always outputting to
meetings/incoming/. Use absolute paths for both the script and the output to avoid working-directory issues:SKILL_SCRIPT="$(ls "${PWD}/.claude/skills/process-transcript/scripts/parse-vtt.py" "${HOME}/.claude/skills/process-transcript/scripts/parse-vtt.py" 2>/dev/null | head -1)" && uv run "$SKILL_SCRIPT" --output-dir meetings/incoming <file1>.vtt <file2>.vttThis creates.mdfiles inmeetings/incoming/with frontmatter and transcript already formatted. - Read each generated
.mdfile and determine: Important: Do not rewrite the transcript through the model. Only prepend the title and summary to the file generated by the script. Keep the transcript output from the script as-is.
- Date: Already in the frontmatter. Verify it looks correct. - Slug: Pick a descriptive slug in kebab-case based on the transcript content (e.g. strategy, progress-sync, brainstorm, planning, one-on-one, kickoff, etc.). - Title: Add a # Meeting Title heading above the ## Transcript section. - Summary: Add a brief 2-3 sentence summary of what the meeting was about between the title and the transcript.
- Move the file to
meetings/YYYY-MM-DD-<slug>.md. - After processing, report which files were created and ask the user whether to delete the processed VTT files from
meetings/incoming/.