source-to-skill Star on GitHub
v0.7.0 Docs, notes, meetings, threads & 11 agents

Turn YouTube videos, podcasts, papers and docs into agent skills.

One command distills the things you watch, listen to and read into an Agent Skill that Claude Code, Codex, Cursor or Gemini CLI loads on demand. Every video and podcast answer links the exact second. No API keys, no cloud, no vector database, and every skill ships with an eval.

/plugin marketplace add michalstrnadel/source-to-skill
/plugin install source-to-skill@source-to-skill

Includes the skill-study, skill-eval and skill-library companions. Then: /source-to-skill <url-or-file>

Works inClaude CodeCodexCursorGemini CLIGitHub CopilotAmpOpenCodeKiroWindsurfFactoryGoose

00:00 Demo

One command. A skill you can ask.

  1. ExtractCaptions, transcript or text are pulled locally and normalized with chapter offsets.
  2. ConfirmYou see the token estimate before your agent reads anything.
  3. GenerateYour agent writes a ~4k-token SKILL.md plus files it opens only when a question needs them.
  4. Ask/your-skill <question> answers with citations and &t= links.
Terminal demo: running /source-to-skill on a YouTube lecture shows extraction details, a token estimate, then the generated skill folder with SKILL.md, timestamped segment files and a cheatsheet.
Screen recording of a real run: source-to-skill extracts a 3Blue1Brown lecture, shows the token estimate, and generates an agent skill whose answers link exact timestamps in the video.

03:12 Real run

A real run, not a mock-up.

A 3Blue1Brown lecture becomes a skill in Claude Code. Ask it anything afterwards and the answer cites the transcript with a link that jumps to the exact second of the video.

05:40 Supported sources

Things you watch, hear and read.

Built for lectures, talks, courses, podcasts and meetings, with answers that link the exact second. Papers, books, docs, notes and the threads where people argue about them come along too, each with the structure that fits it.

YouTube videos

Captions split by the video's own chapters. Captionless videos fall back to local Whisper.

segments/ · every answer links &t=

Playlists & channels

A whole course or channel, one lesson per video. update adds only new lessons.

lessons/ · course cheatsheet

Podcasts & audio

Whole shows from their RSS feed, Apple Podcasts episodes, mp3 URLs, local files, and 1000+ sites via --type audio. Example: Dwarkesh Patel with Andrej Karpathy, 42.1k tokens to a 1.5k SKILL.md.

local Whisper · timestamped segments
NEW

Meeting transcripts

Zoom, Teams or Meet exports as .srt or .vtt. Decisions, action items with owners, who said what.

decisions · action items · speakers.md

Papers

arXiv URLs download automatically. Academic sections are detected in any PDF.

methods · findings · limitations · glossary · citations

Books

EPUB with the standard library alone; PDF books take chapters from the outline.

chapters/ on demand · glossary · cheatsheet
NEW

Docs sites

Any site with llms.txt or llms-full.txt, or a docs URL with --type docs. Example: uv, 56 pages to a 1.7k SKILL.md.

guides/ per docs area · cheatsheet
NEW

Word & PowerPoint

.docx .pptx .odt .odp, in document order. Speaker notes are kept, not dropped.

sections/ · key points · decisions

Web articles

Readable-article extraction drops navigation and footer chrome.

thesis · key claims · highlights

GitHub repos

README and docs/ from one tarball download. No clone.

install · usage · per-area guides
NEW

Hacker News & Reddit threads

A thread URL becomes the consensus and the strongest arguments on each side, every point linked to its comment. Dissent stays separate, never averaged in.

consensus · tips.md · dissent.md
NEW

Notes folders

An Obsidian vault, Markdown folder or Logseq pages/: your own frameworks, hub notes and recorded decisions. Stays on your machine.

topics/ per hub note · decisions.md

Topic skills

Several sources, say a paper, a talk and an article, become one skill that also records where they disagree.

one skill · disagreements.md

09:05 How it works

Deterministic extractor. Your agent writes the skill.

Python does the parts that should never vary. The model you already pay for does the distilling, following one instruction file per source type.

Pipeline: a source goes to the extractor, which writes full_text.txt and metadata.json; your agent (Claude Code, Codex, Cursor, Gemini CLI or another skills host) reads them and generates SKILL.md plus on-demand files and an evals file.

Cheap to query

SKILL.md stays near 4k tokens. Segment, lesson and chapter files load only when a question needs them, so a two-hour lecture doesn't cost two hours of tokens per question.

Structure, not summaries

Frameworks, decision rules, concrete numbers and quotes, shaped per source: methods and limitations for papers, chapters for books, lessons for courses.

Yours, locally

Extraction and Whisper transcription run on your machine. Skills are plain Markdown folders you can read, edit, commit and share.

11:20 Study, eval, library

Measured, not assumed. Then studied and kept fresh.

Every generated skill ships evals/evals.json in the skill-creator format: grounded questions your agent drafts from the original source while it still has it in context. Three companion skills come with the plugin and the installers.

99%127 of 128 expectations

The gallery skills, scored blind.

For each of the 9 skills in the examples gallery, questions were drafted from the original video, course, podcast, paper, book, article, repo, docs or topic sources. An agent holding only the skill answered them and met 127 of 128 expectations.

The plugin also carries a claude plugin eval suite that checks each skill triggers on real requests and stays quiet on unrelated ones.

skill-study

Quizzes you one question at a time with Leitner spaced repetition, asks you to explain ideas back, builds a study plan over the lessons and exports Anki cards with deep links.

/skill-study · quiz · plan · Anki TSV

skill-eval

Drafts grounded questions from the original source, answers them blind with only the skill, scores each expectation, lists the facts the skill is missing and offers fixes.

/skill-eval · score · missing facts · fixes

skill-library

Lists every skill you have made, finds which one covers a question, flags playlists, channels, feeds and docs that have moved on, and refreshes them.

/skill-library · find · flag stale · refresh

13:10 Compare

Why not just paste the transcript?

Because you'd pay for the whole thing on every question, and lose it at the end of the session. Here is how the common options stack up.

Comparison as of October 2026. "Agent" means your coding agent, such as Claude Code, Codex or Cursor.
Capability source-to-skill NotebookLM RAG pipeline Pasting the transcript
Runs in your coding agent Yes, loads as a skill Separate web app Only if you wire it in Yes
No API keys or extra accounts Uses the agent you have Google account, cloud upload Embedding API, vector store Yes
Timestamp deep links Every answer, exact &t= second Passage citations If you build them No
Token cost per question ~4k + only the files needed Not in your agent Retrieved chunks, plus infra The full transcript, every time
Offline-capable extraction Local files, local Whisper Cloud only With local models Depends on your agent
Persists across sessions Installed skill folder In the notebook In the index Gone with the context
Checked against the source Ships grounded evals; gallery scored 99% blind No If you build evals No
Open source MIT No Varies Not applicable

Scroll the table sideways to see every column.

16:30 FAQ

Questions people actually search.

16:30How do I turn a YouTube video into a Claude skill?

Install source-to-skill in Claude Code with /plugin marketplace add michalstrnadel/source-to-skill and /plugin install source-to-skill@source-to-skill (or with npx skills add michalstrnadel/source-to-skill), then run /source-to-skill followed by the video URL. The extractor pulls the captions, splits them by the video's own chapters and shows a token estimate; your agent then writes a SKILL.md plus one segment file per chapter. Every answer links back to the exact second with &t=. Videos without captions fall back to local Whisper transcription.

17:02Can Claude Code learn from a podcast?

Yes. Pass an Apple Podcasts link, a podcast RSS feed, a direct mp3 URL, a local audio or video file, or any page yt-dlp supports (Vimeo, SoundCloud, TED and 1000+ more) with --type audio. source-to-skill transcribes it locally with Whisper (mlx-whisper on Apple Silicon or faster-whisper elsewhere), so no API key is needed, and turns the transcript into a timestamped skill your agent loads on demand.

17:44Does source-to-skill work in Codex, Cursor or Gemini CLI?

Yes. Run npx skills add michalstrnadel/source-to-skill (the Vercel skills CLI, which installs into most agents), or use the bundled installer: uvx source-to-skill install --agent codex. The --agent flag also takes cursor, gemini, copilot, opencode, kiro, windsurf, factory, claude and agents, and --project installs into the current project instead of your home folder. Codex, Amp and Goose read ~/.agents/skills; Cursor reads ~/.cursor/skills and Gemini CLI ~/.gemini/skills. Then ask your agent to turn a URL or file into a skill.

18:27Is there a NotebookLM alternative for Claude Code?

source-to-skill fills that role inside your coding agent. Instead of uploading sources to a separate cloud notebook, it turns them into Agent Skills that live in your skills folder, so Claude Code, Codex, Cursor or any other skills host can consult a lecture, paper or book while it works on your code. It is open source, runs locally and needs no extra account.

19:13How do I make an agent skill from a PDF or book?

Run /source-to-skill with an arXiv URL, a PDF path or an EPUB file. Papers become a skill with a TL;DR plus methods, findings, limitations, glossary and citations files. Books (EPUB, or PDF with --type book) become a chapter index with one chapter file loaded only when a question needs it, plus a glossary and cheatsheet.

19:52How do I turn a documentation site into a skill with llms.txt?

Pass a URL ending in /llms.txt or /llms-full.txt, or any docs URL with --type docs. The extractor looks for the site's llms-full.txt, then llms.txt, and fetches the pages they link. Your agent writes a SKILL.md with what the product is, how to start and its core concepts, one guide per docs area loaded on demand, and a cheatsheet of commands and config keys, each citing the live page URL. Re-running update refreshes the skill when the docs change.

20:34Can I turn my Obsidian vault or Markdown notes into a skill?

Yes. Point it at a local folder: an Obsidian vault, a folder of Markdown notes or Logseq's pages folder. Hidden folders such as .obsidian are skipped. The skill front-loads your own frameworks and recurring ideas, indexes your hub notes as topic files and lists the decisions and open questions you recorded, each with its note path. It runs locally, asks what the skill is for before generating, and leaves out credentials and private entries.

21:19Can it handle meeting transcripts, Word and PowerPoint files, or Hacker News and Reddit threads?

Yes. A Zoom, Teams or Meet export (.srt or .vtt) becomes a skill with the decisions, action items with owners, open questions and each participant's positions, all timestamped. Word, PowerPoint and OpenDocument files (.docx, .pptx, .odt, .odp) become a section index with one file per section, and slide speaker notes are kept. A Hacker News or Reddit thread URL becomes the consensus, the strongest arguments on each side and a separate dissent file, each point linked to its comment.

22:05How do I know a generated skill is good?

Every generated skill ships evals/evals.json in the skill-creator format: questions drafted from the original source while it is still in context. The skill-eval companion answers them blind, using only the skill, scores each expectation, lists the facts the skill is missing and offers fixes. Across the 9 skills in the examples gallery, an agent holding only the skill met 127 of 128 expectations (99%) on questions drafted from the original sources.

22:48Can I turn a whole YouTube playlist or channel into a course skill?

Yes. A playlist or channel URL becomes a course skill: a lesson index, one lesson file per video that opens with a link to that video, and one cheatsheet across the course. When the channel publishes more videos, the update command re-extracts it and adds only the new lessons. The skill-study companion then quizzes you on it with spaced repetition and can export Anki cards that link back to the video.

23:31Does source-to-skill need an API key or send my data to the cloud?

No. Extraction is deterministic Python that runs on your machine, and transcription uses local Whisper. The distillation is done by the coding agent you already use, so there is no extra API key, embedding service or vector database.

24:16Which coding agents can use the generated skills?

Any host that supports the open Agent Skills format: Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Amp, OpenCode, Kiro, Windsurf, Factory, Goose and others. Most of them read ~/.agents/skills; Claude Code reads ~/.claude/skills, and the installer knows each agent's own folder and its project-local equivalent.

24:58How is this different from RAG, documentation scrapers or book-to-skill?

RAG needs embeddings and retrieval infrastructure. Skill_Seekers focuses on API documentation and book-to-skill on books. source-to-skill also handles docs and books, but its edge is what you watch and listen to: videos, courses and podcasts, transcribed locally with Whisper and cited to the exact second, with no API keys. Each skill is a compact SKILL.md of about 4k tokens with support files that load only when needed, so a question costs a fraction of pasting the whole source.

Your next lecture, on call.

Install once in Claude Code, Codex, Cursor or any skills host, then point it at anything worth remembering. Open source under MIT.

npx skills add michalstrnadel/source-to-skill
/source-to-skill <url-or-file>