SuperAPI AI Directory

youtube-transcript

Writing & research

View repository

Updated 10-16 04:05

About this skill

youtube-transcript

Turn a YouTube URL or supplied transcript into a timestamped Obsidian note.

Workflow

  1. If neither URL nor transcript is provided, ask once for the missing source.
  2. For a URL, run scripts/extract_subtitle.py <url> and read the selected .vtt or .srt path from its JSON output.
  3. If extraction fails because yt-dlp is missing or subtitles are unavailable, say so and accept a manual transcript.
  4. Transform the transcript using TEMPLATE.md; load it before writing the note.
  5. Ask for a save location only if the user did not provide one. Use YYYY-MM-DD - [Video Title].md.

Content Rules

  • Never invent facts; mark ambiguous claims as [uncertain: reason].
  • Preserve timestamps for every important section.
  • Explain methods, frameworks, and processes as clear steps or paragraphs.
  • Use Obsidian callouts for quotes, tips, warnings, notes, and caveats.

Script

scripts/extract_subtitle.py "https://www.youtube.com/watch?v=..."

The script prints JSON with subtitle_paths, best_subtitle, and captured yt-dlp output. Prefer best_subtitle; inspect the raw files before summarizing.