yt-viral

Installation
SKILL.md

yt-viral

Raw view counts rank channel size, not ideas. This ranks by multiple over each channel's own median, which is the only version of the question that is about the video.

python3 "$SKILL_DIR/swipe.py" collected.json --min 2.0

Before running the helper, set SKILL_DIR to the full path to the directory containing this SKILL.md. Claude Code provides that path as CLAUDE_SKILL_DIR; other agents should resolve it from the loaded skill file. Do not assume the user's working directory is the skill directory.

Collecting the input

You need at least four videos per channel or a median means nothing, and the tool will skip the channel and tell you it did. Collect them however the user prefers - yt-dlp --flat-playlist -J against a channel URL is the fastest, the public page works, a manual list works.

Installs
9
GitHub Stars
1
First Seen
Oct 29, 2026