Skip to main content
skill CX Codex

yt-audit — Claude Code skill: what it does, how to install

yt-audit is a Claude Code skill that reviews a YouTube channel through titles, thumbnails, the first fifteen seconds, and retention. It starts from an audit request or a pasted channel URL.

MIT 1,300 installs ★ 6,796 updated 2026-09-16

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add Jakeschincariol/youtube-agent-skill --skill yt-audit -a claude-code
Open on GitHub

What yt-audit does

yt-audit reviews a YouTube channel by examining its titles, thumbnails, opening fifteen seconds, upload consistency, and retention shape. The result selects one main fix for the week, names three elements that already work, and marks changes to postpone.

The skill reads ~/.claude/youtube/voice.md when that file exists. If it does not, three videos made by the channel owner are needed: yt-audit reads or transcribes them, infers the creator’s voice, and writes the profile. Titles go through ../yt-package/title.py; opening sections are scored with ../yt-script/hookscore.py; retention data is taken through /yt-retention when it can be exported.

The audit does not publish anything. Each result ends with a copyable block and the question “ship it, or change it?”. Without ~/.claude/youtube/voice.md, the skill uses three of the owner’s videos to build the voice context.

What it helps with

  • compare the last ten titles as one set
  • spot thumbnails that fail at feed size
  • score the opening fifteen seconds of three recent videos
  • check whether uploads follow a consistent rhythm
  • choose one fix for this week

Example prompts for the agent

  • Audit my channel.
  • Why isn't my channel growing?
  • Review my videos and tell me what to fix first.

How to install yt-audit

1Skills CLI (Vercel)

npx skills add Jakeschincariol/youtube-agent-skill --skill yt-audit -a claude-code

2Manually: put the files in place

~/.claude/skills/yt-audit/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/yt-audit/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about yt-audit

How do I install yt-audit in Claude Code?

Run npx skills add Jakeschincariol/youtube-agent-skill --skill yt-audit -a claude-code. The skill file is available at ~/.claude/skills/yt-audit/SKILL.md.

What does yt-audit do?

It examines the last ten titles, thumbnails at feed size, the first fifteen seconds of three recent videos, upload consistency, and retention shape. The output names one main fix, three things already working, and changes to leave for later.

What does yt-audit need to work?

The skill reads ~/.claude/youtube/voice.md when it exists. Otherwise, it needs three videos from the channel owner to infer the voice and create that profile.

Source text

SKILL.md · MIT
---
name: yt-audit
description: >-
  Audit a YouTube channel end to end - packaging, consistency, the first
  fifteen seconds, and what to fix first. Use for "audit my channel", "why
  isn't my channel growing", "review my videos", or a pasted channel URL.
---

# yt-audit

An audit that lists twenty problems is a way of avoiding the one that matters. This ends in ONE fix.

## Before you write

1. Read `~/.claude/youtube/voice.md` if it exists. That is the user's voice profile: how they talk
   on camera, the words they never use, who they are talking to, what they will not claim. If it
   does not exist, ask for **three of their own videos**, read or transcribe them, infer the voice,
   and write the file. A script in the wrong voice is worse than no script, because they have to
   read it out loud.
2. Never invent a number, a result or a source. If a figure would strengthen it and you do not have
   one, ask for it or write the line without it.

## What to look at, in this order

1. **The last ten titles, as a set.** Read them as a list, the way the channel page shows them. Do
   they promise different things? Run them through `../yt-package/title.py`. A channel where every
   title is the same shape has a format problem, not a title problem.
2. **The thumbnails, at feed size.** Shrink them. What survives? If three of them are unreadable at
   that size, that is the fix and nothing else matters yet.
3. **The first fifteen seconds of the three most recent.** Transcribe them and score with
   `../yt-script/hookscore.py`. This is where most channels lose.
4. **Upload rhythm.** Not frequency - CONSISTENCY. Six videos in one week and then nothing for a
   month is worse than one a fortnight forever.
5. **The retention shape**, if they can export it. `/yt-retention`.

## What to hand back

- The single biggest fix, named, with what to do this week.
- Three things that are already working, so they do not break them. Be specific; "your energy is
  good" is not an observation.
- What NOT to do yet, and why.

Never open an audit with praise you do not mean, and never end one with a list of twenty things.

## 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?**

© Jakeschincariol · MIT · Jakeschincariol/youtube-agent-skill

Similar skills

All skills for Marketing and content →

From the same set11

The whole set →
yt-retention yt-retention is a Claude Code skill that analyzes YouTube Studio audience-retention exports to locate viewer drop-offs and suggest script fixes. CX Codex +1 1,400installs yt-script The yt-script Claude Code skill turns a video idea into a YouTube script and scores possible hooks. The agent uses it for requests to draft a video, an opening line, or a hook. CX Codex +1 1,400installs yt-plan yt-plan — a skill for Claude Code plans a week or month of YouTube uploads around available hours and work already in progress. It assigns formats and publishing days. CX Codex +1 1,300installs yt-chapters The yt-chapters Claude Code skill turns a transcript into YouTube chapters. Ask for timestamps or a video split into sections to trigger it. CX Codex +1 1,300installs yt-edit yt-edit — a skill for Claude Code that converts video transcripts into an edit decision list. It identifies timestamps for removing dead air, filler words, and retakes. CX Codex +1 1,300installs yt-seo The yt-seo Claude Code skill writes YouTube descriptions and tags around real search queries. It checks whether the title and opening lines use the terms viewers search for. CX Codex +1 1,300installs yt-shorts yt-shorts — a Claude Code skill that scans long video transcripts to extract standalone segments and write Shorts scripts. It triggers on requests to clip or repurpose videos. CX Codex +1 1,300installs yt-viral The yt-viral Claude Code skill ranks YouTube videos by views relative to their channel’s median. It surfaces title formulas and patterns across videos in a niche. CX Codex +1 1,300installs

More in the catalog

Project sponsors

Companies that keep this analytics open