Skip to main content
skill CX Codex

yt-viral — Claude Code skill: YouTube video research

The yt-viral Claude Code skill ranks YouTube videos by views relative to their channel’s median. It surfaces title formulas and patterns across videos in a niche.

MIT 1,300 installs ★ 6,796 updated 2026-09-16

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add Jakeschincariol/youtube-agent-skill --skill yt-viral -a claude-code
Open on GitHub

What yt-viral does

yt-viral compares each video’s views with the median for its channel, then ranks the results by that ratio. It can help find videos outperforming their channel in a niche or build a swipe file. The swipe.py script reads JSON input and accepts a threshold, such as python3 swipe.py collected.json --min 2.0.

Input can come from public YouTube listings or a manually assembled list; the instructions also describe collecting data with yt-dlp. Each channel needs at least four videos, or the script skips it. The output includes the top five results, their view multiples, a title formula, and one structural feature they share. The formula is a judgement about the title, not proof of why a video succeeded.

The skill does not publish videos. It returns a block to copy, and publishing happens separately. Use public listings only: it does not use logged-in sessions or channel-owner credentials.

What it helps with

  • find videos that outperform their own channel’s typical view count
  • compare competitor videos within a niche
  • spot a shared structure among top-performing videos
  • collect title examples and their formulas

Example prompts for the agent

  • Find videos taking off in my YouTube niche and compare them with their channels’ usual results.
  • Compare competitor videos and describe the pattern shared by the strongest ones.
  • Assess this video’s title formula and compare its views with the channel median.

How to install yt-viral

1Skills CLI (Vercel)

npx skills add Jakeschincariol/youtube-agent-skill --skill yt-viral -a claude-code

2Manually: put the files in place

~/.claude/skills/yt-viral/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/yt-viral/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about yt-viral

How do I install yt-viral in Claude Code?

Run npx skills add Jakeschincariol/youtube-agent-skill --skill yt-viral -a claude-code. The skill file is at ~/.claude/skills/yt-viral/SKILL.md.

What does yt-viral do?

It ranks YouTube videos by their views relative to the median for their channel. It also assigns a title formula and identifies one structural pattern shared by the top results.

How many videos are needed for each channel?

At least four. The script skips channels with fewer videos.

Source text

SKILL.md · MIT
---
name: yt-viral
description: >-
  Find what is actually working in the user's niche on YouTube and rank it
  by how far each video beat its own channel, then name the formula. Use for
  "what's working right now", "find viral videos in my niche", "why did this
  blow up", competitor research, or a swipe file.
---

# 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.

```bash
python3 swipe.py collected.json --min 2.0
```

## 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.

```json
[{"channel":"...","title":"...","views":412000,"url":"...","duration":613}]
```

**Read, do not scrape.** Public listings only, never a logged-in session, never the user's own
account credentials.

## Reading the output

The multiple is the signal. The formula line is a judgement about the TITLE, matched against
[the 21 formulas](../yt-script/hooks.json) - it is not a claim about why the video worked, and you
should say so when you present it.

What to hand back: the top five with their multiples, the formula each used, and the ONE structural
thing they share. Then the harder line - which of those the user could actually make this week, in
their voice, with what they have.

## The gate

Nothing here publishes. This skill writes and you publish. Every output ends in a block the user
copies, and the last line of every run is the question: **ship it, or change it?**

© Jakeschincariol · MIT · Jakeschincariol/youtube-agent-skill

Similar skills

All skills for Marketing and content →

From the same set11

The whole set →
yt-plan yt-plan — a skill for Claude Code plans a week or month of YouTube uploads around available hours and work already in progress. It assigns formats and publishing days. CX Codex +1 1,300installs yt-audit yt-audit is a Claude Code skill that reviews a YouTube channel through titles, thumbnails, the first fifteen seconds, and retention. It starts from an audit request or a pasted channel URL. CX Codex +1 1,300installs yt-chapters The yt-chapters Claude Code skill turns a transcript into YouTube chapters. Ask for timestamps or a video split into sections to trigger it. CX Codex +1 1,300installs yt-edit yt-edit — a skill for Claude Code that converts video transcripts into an edit decision list. It identifies timestamps for removing dead air, filler words, and retakes. CX Codex +1 1,300installs yt-seo The yt-seo Claude Code skill writes YouTube descriptions and tags around real search queries. It checks whether the title and opening lines use the terms viewers search for. CX Codex +1 1,300installs yt-shorts yt-shorts — a Claude Code skill that scans long video transcripts to extract standalone segments and write Shorts scripts. It triggers on requests to clip or repurpose videos. CX Codex +1 1,300installs yt-package The yt-package Claude Code skill pairs YouTube titles with thumbnail text and checks for truncation, repetition, and vague wording. It runs on requests for title ideas or a new package for an existing video. CX Codex +1 1,300installs yt-comment yt-comment — a skill for Claude Code that drafts YouTube comment replies in the creator's voice. It categorizes incoming feedback and generates concise responses. CX Codex +1 1,200installs

Project sponsors

Companies that keep this analytics open