yt-viral

1# yt-viral
2 
3Raw view counts rank channel size, not ideas. This ranks by **multiple over each channel's own
4median**, which is the only version of the question that is about the video.
5 
6```bash
7python3 swipe.py collected.json --min 2.0
8```
9 
10## Collecting the input
11 
12You need at least **four videos per channel** or a median means nothing, and the tool will skip the
13channel and tell you it did. Collect them however the user prefers - `yt-dlp --flat-playlist -J`
14against a channel URL is the fastest, the public page works, a manual list works.
15 
16```json
17[{"channel":"...","title":"...","views":412000,"url":"...","duration":613}]
18```
19 
20**Read, do not scrape.** Public listings only, never a logged-in session, never the user's own
21account credentials.
22 
23## Reading the output
24 
25The multiple is the signal. The formula line is a judgement about the TITLE, matched against
26[the 21 formulas](../yt-script/hooks.json) - it is not a claim about why the video worked, and you
27should say so when you present it.
28 
29What to hand back: the top five with their multiples, the formula each used, and the ONE structural
30thing they share. Then the harder line - which of those the user could actually make this week, in
31their voice, with what they have.
32 
33## The gate
34 
35Nothing here publishes. This skill writes and you publish. Every output ends in a block the user
36copies, and the last line of every run is the question: **ship it, or change it?**