pm7y-youtube-transcript

# YouTube Transcript Summary Generator

This skill downloads transcripts from YouTube videos and creates a structured `TRANSCRIPT.md` summary with key points (including time codes) and a detailed description. It does NOT include the full transcript text.

**Cross-platform:** Works on Windows, macOS, and Linux using Python.

## When to Use This Skill

Activate this skill when the user:
- Provides a YouTube URL and wants the transcript
- Asks to "download transcript from YouTube"
- Wants to "get captions" or "get subtitles" from a video
- Asks to "transcribe a YouTube video"
- Needs text content from a YouTube video

## Output Format

The skill produces a `TRANSCRIPT.md` file containing:
1. **Video metadata** - title, URL
2. **Summary** - brief overview of the video content
3. **Key Points** - main takeaways with time codes (e.g., `[02:34]`)
4. **Detailed Description** - expanded explanation of the content

**Note:** The full transcript text is NOT included in the output.

## How It Works

### Priority Order:
1. **Check if youtube-transcript-api is installed** - install if needed
2. **Extract video ID** from the YouTube URL
3. **Fetch transcript with timestamps** using the API
4. **Get video title** from YouTube
5. **Save timestamped transcript** to temporary file
6. **Analyze and summarize** - identify key points and generate summary
7. **Write TRANSCRIPT.md** - create structured markdown file
8. **Clean up** temporary files

## Installation Check

**IMPORTANT**: Always check if youtube-transcript-api is installed first:

```bash
python -c "import youtube_transcript_api" 2>/dev/null || python3 -c "import youtube_transcript_api" 2>/dev/null
```

### If Not Installed

Install the package (works on all platforms):

```bash
pip install youtube-transcript-api
```

Or with python3:
```bash
pip3 install youtube-transcript-api
```

## Extract Video ID

YouTube URLs come in various formats. Extract the video ID:

| URL Format | Video ID |
|------------|----------|
| `https://