ahmedsakri/youtube-agent-pro / openai/skills/yt-package
yt-package
VerifiedWrite 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.1 KB |
| agents/openai.yaml | config | 260 B |
| title.py | script | 4.3 KB |
title.py
View on GitHub#!/usr/bin/env python3
"""title.py - lint a YouTube title and thumbnail pairing before you publish it.
python3 title.py --title "..." --thumb "AI RAN IT"
python3 title.py titles.txt # one per line, ranked
python3 title.py --title "..." --json
The pairing is the unit, not the title. A title that repeats the thumbnail text wastes half the
click surface, and that is the single most common mistake this checks for.
Length: YouTube truncates around 60 characters on desktop search and around 40 on a mobile home
feed. Both limits are reported because they are different failures - a desktop truncation loses the
tail, a mobile one can lose the subject.
"""
import argparse, json, re, sys, os
DESKTOP, MOBILE, HARD = 60, 40, 100
VAGUE = {"amazing","incredible","insane","crazy","huge","massive","ultimate","best","powerful",
"secret","revolutionary","mindblowing","epic","perfect","complete","everything"}
STOP = {"the","a","an","of","for","to","in","on","and","or","is","are","with","your","you","my","i",
"this","that","it","how","what","why"}
def words(t): return re.findall(r"[a-z0-9']+", t.lower())
def check(title, thumb=None):
t = title.strip()
n = len(t)
issues, good = [], []
if n > HARD: issues.append(("length", f"{n} characters - YouTube's hard limit is {HARD}"))
elif n > DESKTOP: issues.append(("length", f"{n} characters - desktop search cuts near {DESKTOP}"))
else: good.append(f"{n} characters, inside the {DESKTOP}-character desktop cut")
if n > MOBILE:
head = t[:MOBILE].rsplit(" ", 1)[0]
issues.append(("mobile", f'a mobile feed shows about "{head}..." - check the subject survives'))
caps = [w for w in t.split() if len(w) > 2 and w.isupper()]
if len(caps) > 2: issues.append(("shouting", f"{len(caps)} all-caps words - two is the ceiling before it reads as spam"))
elif caps: good.append(f"{len(caps)} all-caps word for emphasis")
v = [w for w in words(t) if w in VAGUE]
if v: issues.append(("vague", f"{', '.join(sorted(set(v)))} - swap for a number, a name or a date"))
nums = re.findall(r"\d[\d,.]*%?", t)
if nums: good.append(f"carries a concrete figure ({', '.join(nums[:3])})")
else: issues.append(("no-number", "no numeral found - consider a concrete detail only when accurate and useful"))
if t.endswith("?"): good.append("open question in the title")
front = [w for w in words(t)[:3] if w not in STOP]
if not front: issues.append(("front-load", "the first three words are all filler - move the subject forward"))
if thumb:
tw, hw = set(words(t)) - STOP, set(words(thumb)) - STOP
shared = tw & hw
if shared:
issues.append(("duplicate", f"thumbnail repeats the title on {', '.join(sorted(shared))} - "
"the thumbnail should say what the title does not"))
else:
good.append("thumbnail and title carry different words")
if len(words(thumb)) > 4:
issues.append(("thumb-length", f"{len(words(thumb))} words on the thumbnail - three is the ceiling at feed size"))
score = max(0, min(100, 100 - 14 * len(issues) + 4 * len(good)))
return {"title": t, "chars": n, "score": score, "issues": issues, "good": good}
def show(r):
print(f'\n "{r["title"]}"')
print(f" {r['chars']} chars score {r['score']}/100")
for k, m in r["issues"]: print(f" x {k:<12} {m}")
for m in r["good"]: print(f" ok {m}")
def main():
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument("file", nargs="?")
parser.add_argument("--title")
parser.add_argument("--thumb")
parser.add_argument("--json", action="store_true")
args = parser.parse_args()
as_json, thumb = args.json, args.thumb
if (args.file is None) == (args.title is None):
parser.error("provide a text file or --title, not both")
try:
lines = [args.title] if args.title is not None else open(args.file, encoding="utf-8").read().splitlines()
except OSError as exc:
parser.error(str(exc))
rows = [check(line, thumb) for line in lines if line.strip()]
if not rows:
parser.error("provide at least one nonempty title")
rows.sort(key=lambda r: -r["score"])
if as_json: print(json.dumps(rows, indent=1)); return
for r in rows: show(r)
print()
if __name__ == "__main__":
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |