utillayer/youtube-agent-skill

Écrire et vérifier le titre et la miniature d'une vidéo YouTube comme une seule unité, en contrôlant les troncatures, les redondances et le flou avant publication. Utilisez-le pour « idées de titres », « comment appeler ça », « texte de miniature », « mon CTR est mauvais », le packaging, ou toute demande de renommage ou de réemballage d'une vidéo existante.

Qu'est-ce que youtube-agent-skill ?

Cette compétence pour agents IA (Claude Code, Cursor, Codex) optimise le packaging des vidéos YouTube en traitant le titre et la miniature comme une seule unité indissociable. Elle évite les erreurs courantes comme la répétition du titre dans la miniature, les troncatures à l'affichage (selon la surface : bureau ou mobile) et l'absence d'éléments forts (chiffre, nom, date). L'outil `title.py` intégré permet de générer et de classer jusqu'à dix titres, d'en sélectionner les trois meilleurs avec leurs scores et problèmes spécifiques, puis de rédiger un brief pour la miniature (expression, cadrage, trois mots maximum). La compétence impose des règles strictes : environ 60 caractères pour le bureau, 40 pour le mobile, une limite dure à 100, pas de balises `< >`, et pas plus de deux mots en majuscules pour éviter l'aspect spam. Pour le choix final, elle propose un test A/B dans YouTube Studio (jusqu'à 3 titres ou miniatures, pas pour les Shorts) pour laisser les données de temps de visionnage trancher plutôt que de se fier uniquement au score du linter. Chaque session se termine par la question : « On valide ou on modifie ? », et rien n'est publié automatiquement.

Compatible avec✓Claude Code✓Codex CLI~Cursor

npx skills add https://github.com/utillayer/youtube-agent-skill/tree/HEAD/skills/yt-package

Documentation

yt-package

Le titre et la miniature forment une seule unité. Les écrire séparément est la raison principale pour laquelle la plupart des packagings échouent : la miniature répète le titre, et la moitié de la surface de clic dit la même chose deux fois.

python3 ${CLAUDE_SKILL_DIR}/title.py --title "..." --thumb "IA A GÉRÉ"
python3 ${CLAUDE_SKILL_DIR}/title.py titles.txt --thumb "IA A GÉRÉ"   # un par ligne, classés

Les outils se trouvent dans le dossier de cette compétence. ${CLAUDE_SKILL_DIR} correspond à ce dossier dans Claude Code ; partout où il ne se développe pas (claude.ai, Codex), utilisez le dossier depuis lequel ce SKILL.md a été chargé.

Avant d'écrire

Lisez ~/.claude/youtube/voice.md s'il existe. C'est le profil vocal de l'utilisateur : comment il parle à l'écran, les mots qu'il n'utilise jamais, à qui il s'adresse, ce qu'il ne prétendra pas. S'il n'existe pas, demandez trois de ses propres vidéos, lisez-les ou transcrivez-les, déduisez la voix, et écrivez le fichier. Un script dans la mauvaise voix est pire qu'aucun script, car l'utilisateur devra le lire à voix haute.
N'inventez jamais un chiffre, un résultat ou une source. Si une donnée renforcerait le propos et que vous n'en avez pas, demandez-la ou écrivez la ligne sans elle.

Règles appliquées par l'outil, et pourquoi

Environ 60 caractères tient sur la recherche bureau, environ 40 sur le fil d'accueil mobile. YouTube ne publie aucun de ces nombres — la troncature est basée sur la largeur en pixels et varie selon la surface — traitez-les donc comme le côté sûr d'un flou, pas comme une règle. Les deux sont signalés car ils échouent différemment : une coupure bureau perd la fin, une coupure mobile peut perdre le sujet. 100 est la limite dure, et < > ne sont pas autorisés.
La miniature ne doit pas répéter le titre. Mots différents, même promesse.
Trois mots maximum sur la miniature. À la taille du fil d'accueil, un quatrième mot est une tache grise.
Un chiffre, un nom ou une date bat n'importe quel adjectif à votre disposition.
Deux mots en majuscules est le plafond avant qu'un titre ne ressemble à du spam.

Écrire dix, garder deux

Générez dix titres, passez-les tous dans title.py, montrez à l'utilisateur les trois premiers avec leurs scores et le problème spécifique de chacun. Pour le gagnant, rédigez le brief de la miniature : l'expression, le cadrage, les trois mots, et ce que l'arrière-plan doit faire pour maintenir le contraste à la taille du fil d'accueil.

Ensuite, laissez YouTube décider

Studio peut tester A/B jusqu'à trois titres, trois miniatures, ou les deux, et choisit en fonction de la part de temps de visionnage. Cela fonctionne sur Studio bureau, nécessite l'activation des fonctionnalités avancées, prend jusqu'à deux semaines, et ne fonctionne pas sur les Shorts. Si les deux premiers sont proches, dites-le et présentez les deux pour un test au lieu de faire comme si le linter pouvait les départager. Le score est un lint, pas une prédiction.

La porte

Rien ici ne publie. Cette compétence écrit et vous publiez. Chaque sortie se termine par un bloc que l'utilisateur copie, et la dernière ligne de chaque exécution est la question : On valide ou on modifie ?