Transcribe

Fetch transcript using the CLI:

youtube_transcript_api VIDEO_ID --format json

If that fails (no transcript available), tell the user and stop.

Generate kebab-case filename from the video title:

• Lowercase, replace spaces/special chars with hyphens
• Remove consecutive hyphens, trim leading/trailing hyphens
• Append .md

Ensure the output directory exists — create it with mkdir -p if needed.

Summarize and format — read the full transcript text and produce structured markdown notes. Follow this format:

# <Video Title>

Source: <youtube-url>

## Overview

<1-2 paragraph summary of the video's main thesis/content>

## <Topic Section>

- **Key point**: explanation
- **Key point**: explanation

## <Another Section>

...additional sections as appropriate...

Guidelines for the summary:

• Use # Title from the video title
• Include Source: <youtube-url> right after the title
• Write a concise Overview section summarizing the video's core message
• Organize content into logical H2 sections based on topics covered
• Use bullet lists for key principles, tips, and takeaways
• Use tables where structured/comparative data makes sense (timelines, comparisons, specs)
• Bold key terms and important concepts
• Keep it practical and actionable — focus on what's useful to reference later
• Don't include filler, repetition, or tangential asides from the video
• Match the style of notes in the project (concise, scannable, reference-friendly)

Write the file to <output-directory>/<kebab-case-title>.md using the Write tool.

Confirm by telling the user:

• The output file path
• A one-line summary of what the video covered