| name | yt-transcript-to-article |
| description | Convert raw YouTube transcripts into polished, high-fidelity readable articles in Markdown. Use this skill whenever the user wants to clean up, rewrite, or convert a YouTube transcript (or multiple transcripts) into an article, blog post, or readable document. Also triggers when the user provides transcript files (txt, html, pdf) or URLs and asks to make them readable, turn them into an article, or clean them up. Even if the user says something casual like "make this transcript readable" or "turn these into a blog post", this skill applies. |
YouTube Transcript to Article
Transform one or more raw YouTube transcripts into a polished, high-fidelity Markdown article that reads like it was written by a skilled editor — while preserving every substantive point, argument, and insight from the source material.
Core Philosophy
The goal is maximum fidelity with maximum readability. These are not in tension — a well-structured article can preserve 100% of the source's substance while being dramatically easier to read than a raw transcript. Never sacrifice content for brevity. The reader should be able to watch the original video afterward and find nothing surprising or missing.
Think of yourself as a world-class editor at a publication like The Atlantic or Ars Technica: you restructure, clarify, and polish — but you never distort, omit, or editorialize.
Input Handling
The user may provide transcripts in any combination of these formats:
| Format | How to access |
|---|
| Plain text file (.txt) | Read the file directly |
| HTML file (.html/.htm) | Read the file; strip HTML tags to extract text content |
| PDF file (.pdf) | Read with the Read tool (it handles PDFs) |
| URL (YouTube or other) |
