DavidROliverBA/.claude/skills/youtube

/youtube

Save a YouTube video as both a Weblink (quick reference) and a detailed Page (full analysis).

Usage

/youtube <url>
/youtube <url> <optional title override>

Examples

/youtube https://www.youtube.com/watch?v=0TpON5T-Sw4
/youtube https://youtu.be/abc123 AWS re:Invent Keynote

Prerequisites

This skill uses the MCP Docker YouTube tools:

• mcp__MCP_DOCKER__get_video_info - Video metadata
• mcp__MCP_DOCKER__get_transcript - Full transcript

Instructions

1. Fetch Video Data

Use both tools in parallel:

mcp__MCP_DOCKER__get_video_info(url)
mcp__MCP_DOCKER__get_transcript(url)

Extract:

• Title, channel name, duration, upload date
• Description (contains links, chapters)
• Full transcript text

If transcript unavailable, note this and proceed with description-only analysis.

2. Parse Chapter Markers

If the description contains chapter timestamps (e.g., 00:00 - Introduction), extract these as structured sections for the Page note.

3. Analyse Content

From the transcript, identify:

• Core thesis - Main argument or purpose
• Key concepts - Major ideas, frameworks, principles
• Actionable insights - What viewers should do
• Technologies/tools - Any mentioned tech stack
• Notable quotes - 2-4 memorable statements
• Relevance to your organization - Architecture, governance, engineering work

4. Create Weblink Note

Filename: Weblink - {{sanitised title}}.md Location: Vault root

---
type: Weblink
title: "{{title}}"
url: {{youtube_url}}
domain: youtube.com
createdAt: {{ISO timestamp}}
created: {{DATE}}
modified: {{DATE}}
tags: [video, {{3-5 relevant tags}}]
---

# {{title}}

**Channel:** {{channel name}}
**Duration:** {{duration}}
**Published:** {{upload date}}

## Summary

{{3-5 sentence summary of video content and main thesis}}

## Key Topics

- {{topic 1}}
- {{topic 2}}
- {{topic 3}}

## Links

- **Video:** {{url}}
- **Channel:** {{channel URL if extractable}}
- **Resources:** {{any links from description}}

## Related

- [[Page - {{title}} - Full Analysis]]

5. Create Page Note (Full Analysis)

Filename: Page - {{sanitised title}} - Full Analysis.md Location: Vault root

---
type: Page
title: "{{title}} - Full Analysis"
created: {{DATE}}
modified: {{DATE}}
tags: [video, activity/research, {{topic tags}}]
confidence: high
freshness: current
source: secondary
verified: true
reviewed: {{DATE}}
summary: {{one-line summary}}
---

# {{title}} - Full Analysis

**Source:** [[Weblink - {{title}}]]
**Author:** {{channel name}}
**Duration:** {{duration}}

## Core Thesis

{{1-2 paragraphs explaining the main argument or purpose}}

## Key Concepts

### {{Concept 1 Name}}

{{Explanation with context}}

### {{Concept 2 Name}}

{{Explanation with context}}

{{Continue for major concepts}}

## Actionable Insights

1. {{Insight 1}}
2. {{Insight 2}}
3. {{Insight 3}}

## Technologies/Tools Mentioned

| Tool | Purpose |
|------|---------|
| {{tool 1}} | {{what it does}} |
| {{tool 2}} | {{what it does}} |

## Notable Quotes

> "{{quote 1}}"

> "{{quote 2}}"

## Relevance to Your Organization Work

{{How this relates to Solutions Architecture, YourOrg projects, or current work. Remove if not applicable.}}

## Chapter Summary

{{If chapters available, list each with 1-2 sentence summary}}

## Transcript

<details>
<summary>Full Transcript (click to expand)</summary>

{{full transcript, cleaned for readability with paragraph breaks}}

</details>

## Related Notes

- {{wiki-links to related vault notes}}

## Resources

- {{Links from video description}}

6. Transcript Formatting

• Add paragraph breaks at natural pauses
• Clean up filler words where excessive
• Preserve speaker changes if multiple speakers
• Keep chapter markers if present

7. Tag Selection

Always include: video

Topic tags (choose 3-5):

• ai, automation, productivity for AI/productivity content
• technology/{{tech}} for specific technologies
• activity/research for learning content
• domain/{{area}} for business domains

8. Find Related Notes

Search vault for:

• Similar topics or technologies
• Related projects
• People mentioned
• Previous videos from same channel

Add wiki-links in Related section.

9. Completion

Report:

• Both file paths created
• Brief summary of video content
• Key relevance if applicable
• Channel name for reference

Quality Standards

• Always fetch transcript - never create without attempting
• Always create BOTH Weblink and Page notes
• Always link them together bidirectionally
• Provide meaningful analysis, not just metadata
• Extract minimum 3 key concepts for substantive videos
• Include full transcript in collapsible section
• Use UK English throughout
• Sanitise titles for filenames (remove special characters)

Example Output

For a 30-minute productivity video:

• Weblink - Building a Second Brain with AI.md (quick reference)
• Page - Building a Second Brain with AI - Full Analysis.md (detailed breakdown)

Both linked together for easy navigation.