distill

Convert source materials into a single structured project knowledge markdown file.

1|Updated Jan 13, 2023
One-click install
npx skills add https://github.com/theodrosyimer/.dotfiles --skill distill-theodrosyimer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: distill
Source: https://github.com/theodrosyimer/.dotfiles/tree/main/claude/skills/dev__distill
Command: npx skills add https://github.com/theodrosyimer/.dotfiles --skill distill-theodrosyimer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yt-dlp, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill turns disparate source materials — YouTube videos and transcripts, blog posts, PDFs, DOCX, Markdown, or pasted text — into a single, well-structured project knowledge markdown file so teams can capture and reuse insights without manual summarization.

Core Features & Use Cases

  • Auto-detects input type: recognizes YouTube URLs/transcripts, web articles, PDFs, DOCX, and plain markdown/text and chooses the appropriate extraction path.
  • Reference-driven output: enforces diagram and documentation conventions by reading provided reference files before producing output.
  • Single-file deliverable: outputs one kebab-case .md file that includes a header block, numbered concept sections, relevance to work, summary, and source footnote — ready to add to project knowledge.
  • Use Case: turn a pasted YouTube transcript or a downloaded PDF into a standards-compliant project knowledge document for onboarding or design reviews.

Quick Start

Paste the source (URL, file, or transcript) and say "distill this" to produce a structured markdown knowledge file.

Frequently Asked Questions about distill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a YouTube transcript into structured markdown documentation?

To convert a YouTube transcript into structured markdown documentation, paste the video URL or transcript text and initiate the process. The system auto-detects the input, extracts relevant information, and outputs a single kebab-case .md file containing headers, numbered concepts, and source footnotes.

Can I extract knowledge from PDFs and DOCX files into a single markdown file?

Yes, you can extract knowledge from PDFs and DOCX files into a single markdown file. The system auto-detects these input formats alongside web pages and pasted text, processing them into one organized project knowledge document with standardized headers and concept sections.

Do I need yt-dlp to process YouTube URLs for knowledge extraction?

Yes, you need yt-dlp installed to process YouTube URLs for knowledge extraction. This dependency allows the system to automatically fetch and extract transcript data from YouTube videos, which is then converted into a structured markdown knowledge file.

What is the best way to turn web articles and blog posts into project knowledge documents?

The best way to turn web articles and blog posts into project knowledge documents is to paste the URLs and let the system auto-detect the web page format. It extracts the core concepts and generates a standards-compliant markdown file with relevance sections and summaries.

How does the system ensure markdown output follows project documentation conventions?

The system ensures markdown output follows project documentation conventions by reading provided diagram and example reference files before authoring. This reference-driven approach enforces strict formatting rules, producing a kebab-case .md file with a standardized header block and numbered sections.

Are there limitations when auto-detecting pasted text versus file inputs for markdown conversion?

When auto-detecting pasted text versus file inputs for markdown conversion, the system handles both but requires pasted text to be clearly delimited. It processes URLs, PDFs, DOCX, and plain text, but always outputs a single kebab-case .md file regardless of the original input format.