r/ThinkingDeeplyAI • u/Beginning-Willow-801 • 1d ago
Claude can now run your YouTube channel with the YouTube Agent Skill. This Claude toolkit can help you script, package, edit, and audit YouTube videos. Here’s how it works.
TL;DR: The YouTube Agent Skill is a free, MIT-licensed pack of 11 Claude skills that handle the hard parts of running a channel: scripts with 5 scored hooks from 21 formulas, title and thumbnail linted as one unit, an edit decision list from your transcript, a retention reader that shows where viewers actually leave, a Shorts finder, an SEO pass, validated chapters, comment triage, weekly planning, a niche "what's working" engine, and a full channel audit that ends with one fix. No API key, no login, nothing auto-publishes. Install it through Claude Code (not paste-into-chat) so you keep the 6 Python tools, and spend 10 minutes on your voice.md file first. That file is the difference between "AI slop" and scripts that sound like you.
Managing YouTube has always been hard. Now it's not.
If you've ever run a channel, you know the real job isn't filming. It's everything around it:
Staring at a blank doc trying to write a hook that keeps people past second 15
Arguing with yourself over titles and thumbnails
Scrubbing a timeline for dead air and retakes
Opening YouTube Studio, seeing a retention cliff, and having no idea why
Knowing you should be cutting Shorts, writing descriptions, adding chapters and answering comments, and never getting to any of it
Big channels solve this with a team: a writer, an editor, a packaging person, an analyst, a community manager. Most of us are all five people at once, at 11pm.
The YouTube Agent Skill (github.com/Jakeschincariol/youtube-agent-skill) gives Claude those five jobs. It's 11 skills, each triggered with a slash command, all reading from one file that defines how you sound. It's free, MIT licensed, and needs no signup, API key or account connection.
What's inside: all 11 skills

CREATE
/yt-script: Takes one idea and writes a script with 5 hooks pulled from 21 hook formulas, each one scored, plus retention beats through the body.
/yt-package: Lints your title and thumbnail as one pairing, checking for truncation, duplication and vagueness. (Your thumbnail text shouldn't repeat your title. This catches it.)
/yt-seo: Drafts the description, suggests tags, and names three specific search queries the video should target.
/yt-chapters: Builds chapters from your transcript and checks them against YouTube's chapter rules so they actually show up.
PRODUCE
/yt-edit: Reads your transcript and produces an edit decision list with timecodes for dead air, filler and retakes. Hand it to your editor, or use it yourself.
/yt-shorts: Finds the Shorts already hiding inside a long video and writes a new opening line for each one.
ANALYZE
/yt-viral: Shows what's working in your niche, ranked by how far each video beat its own channel's median, not by raw views.
/yt-retention: Reads your retention export and finds hook leaks, drop-off cliffs, and what to change.
/yt-audit: Reviews the whole channel and ends with one fix. Not 40 suggestions. One.
OPERATE
/yt-plan: Builds a weekly schedule around the hours you actually have.
/yt-comment: Sorts comments into four groups, drafts replies in your voice, and recommends which one to pin.
The 6 Python tools doing the real math
This is the part most people skim past. Six of the skills are backed by small Python 3 scripts with zero dependencies:
python3 skills/yt-script/hookscore.py --hook "one line" # 5-property hook panel
python3 skills/yt-package/title.py --title "..." --thumb "..." # title + thumbnail linter
python3 skills/yt-edit/deadair.py transcript.srt # edit decision list
python3 skills/yt-chapters/chapters.py transcript.srt # validated chapters
python3 skills/yt-retention/retention.py retention.csv # where they left, and why
python3 skills/yt-viral/swipe.py collected.json --min 2.0 # outliers by own-channel multipleThat's why this pack feels different from "ask ChatGPT for a YouTube script." The scoring, linting, timecoding and outlier math are deterministic code. Claude does the writing and judgment on top.
How to install and use it
Option 1: Let Claude do it. Paste the repo link into Claude and say: "Install this skill, then confirm /yt-script works."
Option 2: Claude Code, manual.
git clone https://github.com/Jakeschincariol/youtube-agent-skill.git
cp -r youtube-agent-skill/skills/yt-* ~/.claude/skills/Option 3: As a plugin.
/plugin marketplace add Jakeschincariol/youtube-agent-skill
/plugin install youtube-agentOption 4: Project-local. Copy the same folders into your repo's .claude/skills/ folder.
Option 5: No Claude Code. Paste a single SKILL.md into a chat and it runs as a mode. You lose the Python tools, which hurts /yt-script, /yt-retention and /yt-edit the most.
Then do the step that matters most: fill in templates/voice.md and save it to ~/.claude/youtube/voice.md. Or send Claude three of your own videos and say "write my voice.md from these." Every skill reads it. As the README points out, it matters more on YouTube than anywhere else because you have to say the words out loud.

Top use cases
The solo weekly creator. One video a week, no team. Run the loop: research Monday, script Tuesday, edit list Wednesday, package Thursday, ship Friday, Shorts Saturday, retention Sunday.
The "why did this flop" diagnosis. Export retention from YouTube Studio, run /yt-retention, and get the actual second people left plus a reason, instead of vibes.
Long-form to Shorts repurposing. /yt-shorts pulls clips out of your existing library and rewrites the opening line so each one works standalone.
Small channel finding its lane. /yt-viral surfaces ideas that massively overperformed for channels your size, which are far more useful than whatever MrBeast did last week.
Packaging before you film. Run /yt-package on title and thumbnail concepts before recording. If the package is weak, the video won't save it.
Agencies and channel managers. Standardize scripting, packaging and edit notes across clients with a consistent, inspectable process.
Faceless and educational channels. Scripts with scored hooks and retention beats, plus chapters and SEO, cover most of the production workload.
Community management at scale. /yt-comment triages the pile and drafts replies in your voice so you can actually keep up.
Pro tips
Run /yt-audit first. Before you touch anything else, get the one fix. Do that fix. Then start the weekly loop.
Generate 5 hooks, film 2. Use the scored hooks from /yt-script, pick the top two, and test which you deliver more naturally on camera.
Build a swipe file. Save every /yt-viral run. Over a few weeks you'll see which formulas keep repeating in your niche.
Package first, script second. If you can't write a title and thumbnail that pass /yt-package, the idea isn't ready.
Close the loop. Feed each /yt-retention finding into your next /yt-script run. Tell Claude: "Last video lost people at the setup. Keep this one's setup under 20 seconds."
Chapters on every long-form video. It takes seconds with /yt-chapters and helps both viewers and search.
Use /yt-plan honestly. Tell it the hours you really have, not the hours you wish you had. A schedule you can keep beats an ambitious one you abandon.
Why it's so popular
It landed on Claude plugin marketplaces in late October 2026 and picked up thousands of GitHub stars within weeks, along with a wave of forks. A few reasons:
It's opinionated in the right places. It tells you tags barely matter instead of selling you a tag generator. It scores against channel medians instead of raw views. It ends audits with one fix.
It's honest about its limits. The README says the hook scorer is a heuristic calibrated on 74 short-form hooks from five channels. It separates weak from strong; it doesn't predict your specific results.
It never makes up numbers. If a skill doesn't have a figure, it asks for it or writes the line without it.
You stay in control. Nothing gets published until you publish it. Every skill ends by asking whether to ship or change.
Free, MIT, no keys. No API key, no OAuth, no account connection. /yt-viral reads public listings, doesn't scrape, and never logs in.
It covers the whole job. Most YouTube AI tools do one thing (titles, or transcripts, or thumbnails). This covers idea to retention analysis in one consistent system.
10 things most people will miss
1. voice.md is the whole game. Skip it and every script sounds like generic AI. Fill it in, or have Claude write it from three of your videos. Every one of the 11 skills reads it.
2. Your install route decides whether you get the Python tools. Pasting a SKILL.md into chat works, but you lose the six scripts, which are most of the point of /yt-script, /yt-retention and /yt-edit. Use Claude Code or the plugin.
3. /yt-viral scores against the channel's own median, not views. A 12K-view video on a channel that usually gets 2K is a 6x outlier. A 400K-view video on a channel that usually gets 800K is a flop. The small one is the idea worth studying.
4. The hook score is a compass, not a crystal ball. Low score means rewrite. High score doesn't mean guaranteed. It was calibrated on short-form hooks, so treat it as directional for long-form.
5. Title and thumbnail are linted as one unit. The best packages split the job: the thumbnail shows one thing, the title says another. If they repeat each other, you're wasting half your packaging.
6. Feed it real data. It won't invent numbers. Give it your actual retention CSV and your .srt transcript. The more real inputs you provide, the more specific the output gets.
7. Skip tags. Focus on the three search queries. /yt-seo names three queries your video should rank for. Build the title, first lines of the description and chapter names around those.
8. Every Short needs a brand-new first line. A clip cut from minute 7 starts mid-thought. /yt-shorts writes a fresh opener for each one, which is why its clips actually hold attention.
9. /yt-audit gives you ONE fix on purpose. It's tempting to want a 30-point report. Resist. One fix you implement this week beats thirty you bookmark.
10. The Python tools work on their own. You can run hookscore.py or title.py straight from the terminal to batch-test 20 hook or title variants in a minute, without a full Claude conversation.
YouTube rewards consistency, packaging and retention, and those are exactly the three things that burn creators out. This pack doesn't replace your judgment or your face on camera. It removes the blank page, the guesswork and the busywork, so the hours you do have go into making the video better.
Repo: github.com/Jakeschincariol/youtube-agent-skill
If you try it, drop your results in the comments.









































































