YouTube to Skill

Transform YouTube tutorials into AI agent skills that actually work.

The Problem

Video Knowledge is Trapped

YouTube contains millions of programming tutorials, but this knowledge is:

1. Inaccessible to AI assistants — AI agents cannot watch videos
2. Time-consuming to extract — A 10-minute video takes 10 minutes to watch
3. Often outdated — APIs change, libraries deprecate, best practices evolve
4. Not actionable — Narrative format (“so what we’re gonna do…”) ≠ executable instructions

The Skill Quality Problem

AI agent skills extend an agent’s capabilities. However, creating effective skills requires understanding:

• How agents discover skills (via description matching)
• The difference between narrative and imperative content
• Current state of mentioned technologies

Without this knowledge, generated skills are often:

• Never activated (poor descriptions)
• Unusable (incomplete instructions)
• Harmful (outdated information)

The Solution

This skill automates the transformation pipeline:

┌─────────────┐     ┌─────────────┐     ┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   EXTRACT   │────▶│  IDENTIFY   │────▶│   VERIFY    │────▶│  TRANSFORM  │────▶│  GENERATE   │
│  transcript │     │technologies │     │  up-to-date │     │   content   │     │    skill    │
└─────────────┘     └─────────────┘     └─────────────┘     └─────────────┘     └─────────────┘

1. Extract

Pulls transcripts from YouTube using captions API (with Whisper fallback):

python scripts/extract_youtube.py "https://youtube.com/watch?v=..."

Output: JSON with metadata (title, channel, date) and full transcript.

2. Identify

Scans transcript for technologies:

• Languages and versions
• Frameworks and libraries
• APIs and services
• CLI tools

3. Verify

Videos get outdated. Skills must not.

Uses available tools to verify current state:

When outdated content is detected, the user is asked how to proceed:

• Update to current version
• Keep original with warnings
• Skip the section

4. Transform

Converts narrative video content to actionable skill instructions:

5. Generate

Produces a SKILL.md following the standard skill format:

---
name: lowercase-with-hyphens
description: Action verb + what + when to use (max 1024 chars)
---

File Structure