process-transcript

Installation
SKILL.md

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 clean Speaker: text transcript (blank line between each turn). Supports --output-dir to control where .md files are written.

Steps

  1. Find VTT files: Check both meetings/incoming/ and ~/Downloads/ for .vtt files. Automatically process, without asking, every .vtt file modified within the last 24 hours (plus anything already sitting in meetings/incoming/). List the files you selected with their stat timestamps so the user can see what was picked, but do not wait for confirmation. Ignore older files unless the user explicitly asks for them. If no recent files are found in either location, tell the user and stop.

  2. 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>.vtt
    

    This creates .md files in meetings/incoming/ with frontmatter and transcript already formatted.

Installs
10
Repository
apocohq/skills
GitHub Stars
4
First Seen
Mar 25, 2026