Skip to main content
skill CX Codex

yt-package — Claude Code skill for YouTube packaging

The yt-package Claude Code skill pairs YouTube titles with thumbnail text and checks for truncation, repetition, and vague wording. It runs on requests for title ideas or a new package for an existing video.

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-package -a claude-code
Open on GitHub

What yt-package does

The skill drafts YouTube titles and thumbnail copy as a single package, then checks each pair for repetition, truncation, and vague phrasing. The title.py script checks an individual title and thumbnail or ranks entries from titles.txt.

It generates ten title options, presents the top three with scores and specific issues, then outlines the thumbnail for the chosen title: expression, framing, text, and background. It does not publish videos. Running the checks requires python3. If ~/.claude/youtube/voice.md is missing, the skill asks for three of the creator’s videos to infer their voice and write the profile file.

What it helps with

  • pair a video title with distinct thumbnail copy
  • catch title or thumbnail text that may be cut off
  • rank candidate titles from titles.txt
  • draft a visual brief for the selected title

Example prompts for the agent

  • Suggest ten titles for my video and check each against its thumbnail text.
  • Repackage this published video with a new title and thumbnail wording.
  • Rank the options in titles.txt and explain the issues with the best ones.

How to install yt-package

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

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

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

Questions about yt-package

How do I install yt-package in Claude Code?

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

What does yt-package do?

It creates and checks YouTube titles alongside thumbnail text, flagging repetition, truncation, and vague wording. For the chosen title, it drafts a visual brief; it does not publish the video.

What does yt-package need to run?

The checks require python3. If ~/.claude/youtube/voice.md does not exist, provide three of the creator’s videos so the skill can infer their voice and create the profile.

Source text

SKILL.md · MIT
---
name: yt-package
description: >-
  Write and lint the title and thumbnail for a YouTube video as one pairing,
  checking truncation, duplication and vagueness before publish. Use for
  "title ideas", "what should I call this", "thumbnail text", "my CTR is
  bad", packaging, or any request to rename or repackage an existing video.
---

# yt-package

The title and the thumbnail are ONE unit. Writing them separately is why most packaging fails: the
thumbnail repeats the title, and half the click surface says the same thing twice.

```bash
python3 title.py --title "..." --thumb "AI RAN IT"
python3 title.py titles.txt            # one per line, ranked
```

## 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.

## Rules the tool enforces, and why

- **60 characters** is where desktop search truncates, **40** is a mobile home feed. Both are
  reported because they fail differently: a desktop cut loses the tail, a mobile cut can lose the
  subject.
- **The thumbnail must not repeat the title.** Different words, same promise.
- **Three words maximum on the thumbnail.** At feed size a fourth word is a grey smear.
- **A number, a name or a date** beats every adjective available to you.
- **Two all-caps words is the ceiling** before a title reads as spam.

## Write ten, keep two

Generate ten titles, run them all through `title.py`, show the user the top three with their scores
and the specific issue on each. For the winner, write the thumbnail brief: the expression, the
framing, the three words, and what the background has to do to hold contrast at feed size.

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

SKILL.md skills catalog →

From the same set11

The whole set →
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-audit 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. 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 yt-comment yt-comment — a skill for Claude Code that drafts YouTube comment replies in the creator's voice. It categorizes incoming feedback and generates concise responses. CX Codex +1 1,200installs

Project sponsors

Companies that keep this analytics open