YouTube Agent Skill

# YouTube Agent Skill: setup notes

This kit holds setup notes written by Mindket. It does not contain the skills, their Python tools or the voice template. Those install from Jake Schincariol’s repository: https://github.com/Jakeschincariol/youtube-agent-skill

License: MIT, Copyright (c) 2026 Jake Schincariol. Full text: https://github.com/Jakeschincariol/youtube-agent-skill/blob/main/LICENSE

YouTube Agent Skill is a community project by Jake Schincariol. It is not made or endorsed by Anthropic or by YouTube.

The pages these notes came from: the README (https://github.com/Jakeschincariol/youtube-agent-skill/blob/main/README.md), each skill’s SKILL.md under https://github.com/Jakeschincariol/youtube-agent-skill/tree/main/skills, the voice template (https://github.com/Jakeschincariol/youtube-agent-skill/blob/main/templates/voice.md), the plugin files in https://github.com/Jakeschincariol/youtube-agent-skill/tree/main/.claude-plugin and the six Python scripts in the skill folders. Facts about where Claude Code loads skills and plugins come from Claude Code’s own docs, named where they are used. Mindket copied every command and ran none of them.

## What it is

Eleven skills for Claude, one slash command per job on a channel. Six of them carry a small Python 3 script that does the counting, such as scoring a hook or listing the cuts in a transcript. The README calls those scripts the reason the skills are not just prompts.

Every skill ends with a block you copy and the question “ship it, or change it?”. Nothing is posted to YouTube for you. In the README’s words: “These skills write. You upload.”

## The eleven skills

| Command | What it does | Python tool |
|---|---|---|
| /yt-script | Five hooks off 21 formulas, scored, the top two kept, then the spoken script beat by beat | hookscore.py |
| /yt-package | The title and the thumbnail words, written and checked as one pair | title.py |
| /yt-edit | An edit decision list from a timestamped transcript: dead air, filler and retakes | deadair.py |
| /yt-comment | Pasted comments sorted into four piles, with short replies and the one to pin | none |
| /yt-plan | A week sized to your hours: one anchor video, one cheap one, three Shorts | none |
| /yt-viral | Videos from channels in your niche, gathered the way you choose, ranked by views over each channel’s own median | swipe.py |
| /yt-retention | A YouTube Studio retention export read for the hook leak, the cliffs and the slide | retention.py |
| /yt-shorts | Spans of 20 to 55 seconds inside a long video that work as Shorts, each with a new first line | uses hookscore.py |
| /yt-seo | A description led by its two most-read lines, up to about fifteen tags and three searches the video should win | none |
| /yt-chapters | Chapters from a transcript, checked against YouTube’s chapter rules | chapters.py |
| /yt-audit | A channel review that ends in one fix | uses title.py and hookscore.py |

Source: the README’s table “The eleven” and each SKILL.md.

## Files in this kit

- setup/claude-code.md: the README’s two routes (paste a line into Claude and let it install the pack, or clone and copy in Claude Code), and an install for one project only
- setup/plugin.md: the plugin route, two commands inside Claude Code
- setup/any-chat.md: one SKILL.md pasted into a Claude chat, without Claude Code
- setup/first-run.md: voice.md, the six tools run by hand, and the input each tool wants

## What you need first

- Claude Code, for the slash commands and the six tools. Without it, one skill at a time runs in a Claude chat (setup/any-chat.md).
- Python 3 for the tools. The README says they run on “a clean Python 3 with no dependencies”, so there is nothing to install with pip. Its commands say python3. On Windows, Python’s own guide (https://docs.python.org/3/using/windows.html) uses python or py, and says the python3 command that its Python install manager adds is not meant to be widely used.
- Git, for the clone route.
- yt-dlp only if /yt-viral gathers video lists with it. It is a separate program, and yt-viral’s SKILL.md names other ways too.
- No account, sign-up or API key for the pack itself. The README: “Free, MIT, no signup, no API key, nothing to connect.” Claude itself runs on your Claude account.

## What installs where

- Clone and copy: eleven folders named yt-* in ~/.claude/skills/, each with its SKILL.md and, for six of them, a Python tool. The yt-script folder also carries hooks.json, the 21 hook formulas.
- One project only: the same eleven folders in your repository’s .claude/skills/.
- Plugin: Claude Code keeps the plugin’s files itself, and its skills run under the plugin’s name (setup/plugin.md).
- voice.md: one file you write at ~/.claude/youtube/voice.md (setup/first-run.md).

Keep the eleven folders together. chapters.py loads the transcript reader in yt-edit, and so does retention.py when you give it a transcript. swipe.py reads hooks.json in yt-script. /yt-shorts runs hookscore.py from yt-script, and /yt-audit runs it and title.py from yt-package.

## Your data

The skills write text for you to copy, and you post it yourself. The six tools read the files you hand them and the pack’s own files, such as hooks.json and yt-edit’s transcript reader. Mindket read each script, and none imports a network library. /yt-viral works from a list of videos that Claude gathers the way you prefer, or that you hand over, and its SKILL.md says to use public listings only, never a logged-in session. What you paste or give Claude, such as transcripts and comments, goes to Claude as in any other Claude work.

## Update and remove

The README gives no update or removal step. setup/claude-code.md and setup/plugin.md say what Claude Code’s own docs give for removing a skill or a plugin.

README.md  6 KB
setup/any-chat.md  2 KB
setup/claude-code.md  3 KB
setup/first-run.md  6 KB
setup/plugin.md  2 KB