youtube-agent-skill README

The project's README from github.com/Jakeschincariol/youtube-agent-skill. As one markdown file: README.md.

The YouTube agent skill

Eleven Claude skills that run a YouTube channel. Free, MIT, no signup, no API key, nothing to connect.

One of them writes your script off 21 hook formulas and scores the hook before you waste a take on it. One lints the title and the thumbnail as a single pairing, because writing them separately is why half of your click surface says the same thing twice. One reads your audience-retention export and tells you the exact second people left and what you were saying when they did. One turns a transcript into an edit decision list. One finds the Shorts already hiding inside a long video. One goes and finds what is working in your niche and ranks it by how far each video beat its own channel, not by how big the channel is.

Nothing gets published until you do it. These skills write. You upload.

Install

Paste this into Claude:

https://github.com/Jakeschincariol/youtube-agent-skill

Install this skill, then confirm /yt-script works.

Or do it yourself, in Claude Code:

git clone https://github.com/Jakeschincariol/youtube-agent-skill.git
cp -r youtube-agent-skill/skills/yt-* ~/.claude/skills/

Or as a plugin:

/plugin marketplace add Jakeschincariol/youtube-agent-skill
/plugin install youtube-agent

Project-local instead of global: copy the same folders into your repo's .claude/skills/. No Claude Code at all? Paste any single SKILL.md at the top of a chat and it runs as a mode. You lose the six Python tools, which is most of the point of /yt-script, /yt-retention and /yt-edit, but the rest works.

Then spend ten minutes on templates/voice.md. Copy it to ~/.claude/youtube/voice.md and fill it in, or send Claude three of your own videos and say "write my voice.md from these". Every skill reads that file. It matters more here than anywhere else, because you have to say the words out loud.

The eleven

command what it does
/yt-script One idea into a script. Five hooks off 21 formulas, scored, then the spoken script with the retention beats marked.
/yt-package Title and thumbnail as one pairing, linted for truncation, duplication and vagueness.
/yt-edit A transcript into an edit decision list: dead air, filler cues, retakes, with timecodes.
/yt-comment The comment section triaged into four piles, then replies in your voice. Says which one to pin.
/yt-plan A week that fits the hours you actually have. One anchor, one cheap one, three Shorts.
/yt-viral What is working in your niche, ranked by multiple over each channel's own median.
/yt-retention Your retention export read properly: hook leak, the cliffs, the slide, and what to change.
/yt-shorts The Shorts already inside a long video, with a new first line written for each.
/yt-seo The description, the tags that are worth having, and the three queries this should win.
/yt-chapters Chapters from a transcript, validated against YouTube's own rules so they render.
/yt-audit The whole channel, ending in ONE fix rather than twenty.

The six tools

Every one of these runs on a clean Python 3 with no dependencies. They are the reason the skills are not just prompts.

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 multiple

The fine print

The part most packs leave out.

It does not publish. YouTube's Data API would allow it with your own OAuth, which makes this pack different from the LinkedIn and Instagram ones, where posting is not available at all. It is still not built here: every skill ends in a block you copy and a question — ship it, or change it? Anything that claims to run your channel unattended should be read with that distinction in mind.

hookscore.py is a heuristic, not a predictor. The panel was built and calibrated against 74 real short-form hooks (the first 15 seconds of auto-captions, top-8 and bottom-8 by views across five channels). It separates deliberately bad hooks from real ones well. It separates a given creator's hits from their own misses barely at all. A low score is a reason to look again; a high score is not a promise.

The formula classifier is about the words, not the result. When /yt-viral says a title used The Statistic, that is a judgement about the title you can see, not a claim about why the video got its views.

/yt-viral reads, it does not scrape. Public listings only. It never logs in as you and never touches your credentials.

Tags barely matter and this pack says so instead of selling you a tag generator.

Nothing invents a number. If a skill wants a figure it does not have, it asks you for it or writes the line without it.

Licence

MIT. Use it, change it, ship it.

youtube-agent-skill (Jakeschincariol/youtube-agent-skill)

Searching Database…

1.6K ·GitHub
Youtube-agent-skill
What is this?A pack of eleven Claude Skills that handle the day-to-day work of running a YouTube channel: writing scripts off hook formulas, linting title/thumbnail pairs, reading retention exports, building edit decision lists, pulling Shorts out of long videos, and ranking what's working in your niche. It is free, MIT-licensed, and needs no signup or API key.
Is this a set of AI prompts or does it include real tools?Both: each skill is a SKILL.md Claude reads, but six of them also ship small Python 3 scripts (like the hook scorer) with no extra dependencies, which is what makes them more than just prompts.
How do I install the skill pack?Paste it into a Claude conversation, install it in Claude Code, or add it as a plugin; for a project-only setup, copy the same skill folders into your repo's .claude/skills/ directory instead of installing globally.
Do I need Claude Code or an API key to use this?No signup or API key is required at all. Claude Code is needed to run the six Python tools behind commands like /yt-script and /yt-retention; without it you can still paste a single SKILL.md into any Claude chat and use it as a prompt-only mode, just without those script-driven commands.
Does it actually publish videos for me?No — nothing gets posted automatically. It does not touch YouTube's publishing API; that would require your own OAuth setup, which this pack doesn't set up, so every skill ends with a draft you approve yourself.
Does /yt-viral log into other channels to pull its data?No — /yt-viral only reads public video listings in your niche; it never logs in as you and never touches your credentials.
How do I get the skills to write in my own voice?Fill out templates/voice.md by hand, or send Claude three of your own videos and ask it to draft the file for you, then save it to ~/.claude/youtube/voice.md — every skill reads that file before writing anything.
How reliable is the hook score from /yt-script?hookscore.py is a heuristic calibrated on just 74 real short-form hooks, so it reliably flags obviously weak hooks but barely tells a creator's own hits apart from their own misses — treat a high score as a maybe, not a promise.
What do the eleven /yt- commands cover?Scripting (/yt-script), title/thumbnail linting (/yt-package), edit decision lists (/yt-edit), comment triage (/yt-comment), weekly planning (/yt-plan), niche virality ranking (/yt-viral), retention analysis (/yt-retention), Shorts extraction (/yt-shorts), SEO (/yt-seo), chapter generation (/yt-chapters), and a one-fix channel audit (/yt-audit).
Does the channel audit dump a long list of fixes on me?No — /yt-audit is built to end in exactly one recommended fix for the whole channel instead of twenty scattered suggestions.
What are similar projects?linkedin-agent-skill, ai-marketing-skills, marketing-agi, marketingskills, open-steps, guizang-product-video-skill, herk-edit-kit, instagram-agent-skill
Which topics is it in?seo, social-media, claude-skill, video-editing, claude-code-plugin, youtube, content-creation, agent-skill, skill, video, skills, claude
Creator
Jakeschincariol
Size
<0.1 MB
Stars
1.6K
Updated
CommitSep 16
Age
1mo
Commits · 90 Days