How do I install the Yt Summarize skill?

Run npx skillmds@latest add hankunpeng/yt-summarize in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Yt Summarize safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Yt Summarize?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Yt Summarize free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Yt Summarize?

hankunpeng (@hankunpeng) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Yt Summarize by hankunpeng — Agent Skill

Name: Yt Summarize
Author: hankunpeng

Yt Summarize

Downloads YouTube subtitles and summarizes the video content using Gemini models while filtering out sponsor promotions. Use when the user asks to summarize, analyze, or get details from a YouTube URL.

hankunpeng 39b6968 4 files · 24.6 KB Updated Sep 17, 2026

File contents

YouTube Video Summarization Skill

This skill allows downloading subtitles of YouTube videos and summarizing their contents using Gemini models. It filters out sponsor promotions and can start an interactive chat session about the video.

Features

Subtitles-based Summary: Summarizes YouTube videos by downloading their subtitles or auto-generated subtitles using yt-dlp. No large video downloads are required.
Sponsor Filtering: Configured to ignore sponsor/promotional content in the summary.
Interactive Chat: Allows starting a follow-up chat session to ask questions about the video.
Multi-language Support: Can extract subtitles in specified languages.

Prerequisites

Ensure the following tools are installed on your system:

yt-dlp (e.g. brew install yt-dlp)
python3
httpx (pip3 install httpx)
myopenai (a custom package/module present on your system)

Files Included

scripts/yt-summarize.py: The Python script that runs yt-dlp and calls the Gemini/LLM API.
scripts/install.sh: Helper script to copy yt-summarize.py to the app data directory, grant execution permissions, and set up a command alias.

Usage

Install or Update:

<skill_dir>/scripts/install.sh

Run from command line:

yt-summarize <youtube-url> [--lang <lang-code>] [--model <model-name>]

For example, to summarize a video:

yt-summarize https://www.youtube.com/watch?v=dQw4w9WgXcQ

To summarize with Chinese subtitles (if available):

yt-summarize https://www.youtube.com/watch?v=dQw4w9WgXcQ --lang zh-Hans

Troubleshooting

1. Zsh: no matches found

If you encounter zsh: no matches found: <url> error, it is because of the ? character in the YouTube URL. Wrap the URL in double quotes:

yt-summarize "https://www.youtube.com/watch?v=Rtkac4WHC1o"

2. Bot verification issues

If you see Sign in to confirm you’re not a bot, pass browser cookies using the --ytdlp-arg flag. On macOS, Chrome cookies are recommended:

yt-summarize "https://www.youtube.com/watch?v=Rtkac4WHC1o" --ytdlp-arg "--cookies-from-browser chrome"

(Note: Using --cookies-from-browser safari may fail due to macOS container sandbox permission issues.)

3. API Key Issues

If the API key is not detected (e.g. for Gemini), you can specify another provider (like deepseek or openai) and pass the corresponding key:

yt-summarize "https://www.youtube.com/watch?v=Rtkac4WHC1o" --api deepseek

---name: yt-summarizedescription: Downloads YouTube subtitles and summarizes the video content using Gemini models while filtering out sponsor promotions. Use when the user asks to summarize, analyze, or get details from a YouTube URL.---# YouTube Video Summarization SkillThis skill allows downloading subtitles of YouTube videos and summarizing their contents using Gemini models. It filters out sponsor promotions and can start an interactive chat session about the video.## Features- **Subtitles-based Summary**: Summarizes YouTube videos by downloading their subtitles or auto-generated subtitles using `yt-dlp`. No large video downloads are required.- **Sponsor Filtering**: Configured to ignore sponsor/promotional content in the summary.- **Interactive Chat**: Allows starting a follow-up chat session to ask questions about the video.- **Multi-language Support**: Can extract subtitles in specified languages.## PrerequisitesEnsure the following tools are installed on your system:- `yt-dlp` (e.g. `brew install yt-dlp`)- `python3`- `httpx` (`pip3 install httpx`)- `myopenai` (a custom package/module present on your system)## Files Included- `scripts/yt-summarize.py`: The Python script that runs `yt-dlp` and calls the Gemini/LLM API.- `scripts/install.sh`: Helper script to copy `yt-summarize.py` to the app data directory, grant execution permissions, and set up a command alias.## Usage### Install or Update:```bash<skill_dir>/scripts/install.sh```### Run from command line:```bashyt-summarize <youtube-url> [--lang <lang-code>] [--model <model-name>]```For example, to summarize a video:```bashyt-summarize https://www.youtube.com/watch?v=dQw4w9WgXcQ```To summarize with Chinese subtitles (if available):```bashyt-summarize https://www.youtube.com/watch?v=dQw4w9WgXcQ --lang zh-Hans```## Troubleshooting### 1. Zsh: no matches foundIf you encounter `zsh: no matches found: <url>` error, it is because of the `?` character in the YouTube URL. Wrap the URL in double quotes:```bashyt-summarize "https://www.youtube.com/watch?v=Rtkac4WHC1o"```### 2. Bot verification issuesIf you see `Sign in to confirm you’re not a bot`, pass browser cookies using the `--ytdlp-arg` flag. On macOS, Chrome cookies are recommended:```bashyt-summarize "https://www.youtube.com/watch?v=Rtkac4WHC1o" --ytdlp-arg "--cookies-from-browser chrome"```*(Note: Using `--cookies-from-browser safari` may fail due to macOS container sandbox permission issues.)*### 3. API Key IssuesIf the API key is not detected (e.g. for Gemini), you can specify another provider (like `deepseek` or `openai`) and pass the corresponding key:```bashyt-summarize "https://www.youtube.com/watch?v=Rtkac4WHC1o" --api deepseek```

Frequently asked questions