yt-viral

Q: How do I install yt-viral?

Run npx skills add https://github.com/jakeschincariol/youtube-agent-skill --skill yt-viral in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/yt-viral/ (personal) or .claude/skills/yt-viral/ (project).

by jakeschincariolMedia & Creative

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.

Installs: 454
Last 24h: +41
Trending rank: #3833
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/jakeschincariol/youtube-agent-skill --skill yt-viral

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads yt-viral automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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

[{"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 - 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?

FAQ

What does the yt-viral skill do?

How do I install yt-viral?

Run npx skills add https://github.com/jakeschincariol/youtube-agent-skill --skill yt-viral in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/yt-viral/ (personal) or .claude/skills/yt-viral/ (project).

Which AI agents can use yt-viral?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is yt-viral safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains yt-viral?

It is published by jakeschincariol in jakeschincariol/youtube-agent-skill. It has 454 recorded installs.