Communitygithub.com

utillayer/youtube-agent-skill

Escribe y revisa el título y la miniatura de un video de YouTube como una sola unidad, verificando truncamiento, duplicación y ambigüedad antes de publicar. Útil para 'ideas de títulos', '¿cómo debería llamar esto?', 'texto de miniatura', 'mi CTR es malo', empaquetado o cualquier solicitud para renombrar o reempaquetar un video existente.

¿Qué es youtube-agent-skill?

Este skill para agentes de IA (como Claude Code, Cursor o Codex) automatiza la creación y revisión conjunta del título y la miniatura de un video de YouTube, tratándolos como una sola unidad de empaquetado. Es útil cuando necesitas generar ideas de títulos, mejorar el CTR, renombrar un video existente o diseñar el texto de la miniatura. El skill incluye herramientas de línea de comandos (title.py) que validan reglas clave: longitud máxima de título (100 caracteres), advertencias de truncamiento en escritorio (~60 caracteres) y móvil (~40 caracteres), que la miniatura no repita el título, un máximo de tres palabras en la miniatura, y límite de dos palabras en mayúsculas. Además, recomienda generar diez títulos, mostrar los tres mejores con sus puntuaciones y problemas específicos, y luego escribir un brief de miniatura. Finalmente, sugiere usar la prueba A/B de YouTube Studio (hasta tres títulos y tres miniaturas) para decidir basado en tiempo de reproducción, pero el skill solo lintiza, no publica. No funciona en Shorts. El skill también puede leer un perfil de voz del usuario (voice.md) o inferirlo de sus videos para asegurar que el tono sea consistente.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/utillayer/youtube-agent-skill/tree/HEAD/skills/yt-package

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

yt-package

El título y la miniatura son UNA unidad. Escribirlos por separado es la razón por la que falla la mayoría del empaquetado: la miniatura repite el título, y la mitad de la superficie de clic dice lo mismo dos veces.

python3 ${CLAUDE_SKILL_DIR}/title.py --title "..." --thumb "AI RAN IT"
python3 ${CLAUDE_SKILL_DIR}/title.py titles.txt --thumb "AI RAN IT"   # uno por línea, ordenados

Las herramientas están en la carpeta de este skill. ${CLAUDE_SKILL_DIR} es esa carpeta en Claude Code; en cualquier lugar donde no se expanda (claude.ai, Codex), usa la carpeta desde la que se cargó este SKILL.md.

Antes de escribir

  1. Lee ~/.claude/youtube/voice.md si existe. Ese es el perfil de voz del usuario: cómo habla en cámara, las palabras que nunca usa, a quién le habla, lo que no afirmará. Si no existe, pide tres de sus propios videos, léelos o transcríbelos, infiere la voz y escribe el archivo. Un guion en la voz equivocada es peor que ningún guion, porque tienen que leerlo en voz alta.
  2. Nunca inventes un número, un resultado o una fuente. Si una cifra lo fortalecería y no tienes una, pídela o escribe la línea sin ella.

Reglas que la herramienta aplica, y por qué

  • Alrededor de 60 caracteres sobrevive en la búsqueda de escritorio, alrededor de 40 en la página de inicio móvil. YouTube no publica ninguno de los dos números: el truncamiento es por ancho de píxel y varía según la superficie, así que trátalos como el lado seguro de una zona borrosa, no una regla. Ambos se reportan porque fallan de manera diferente: un corte en escritorio pierde la cola, un corte en móvil puede perder el tema. 100 es el límite estricto, y < > no están permitidos.
  • La miniatura no debe repetir el título. Palabras diferentes, misma promesa.
  • Máximo tres palabras en la miniatura. En el tamaño del feed, una cuarta palabra es una mancha gris.
  • Un número, un nombre o una fecha supera cualquier adjetivo disponible para ti.
  • Dos palabras en mayúsculas es el techo antes de que un título parezca spam.

Escribe diez, guarda dos

Genera diez títulos, pásalos todos por title.py, muéstrale al usuario los tres mejores con sus puntuaciones y el problema específico de cada uno. Para el ganador, escribe el brief de la miniatura: la expresión, el encuadre, las tres palabras y qué tiene que hacer el fondo para mantener contraste en el tamaño del feed.

Luego deja que YouTube decida

Studio puede probar A/B hasta tres títulos, tres miniaturas o ambos, y elige por tiempo de reproducción compartido. Funciona en Studio de escritorio, necesita funciones avanzadas activadas, tarda hasta dos semanas y no funciona en Shorts. Si los dos primeros están cercanos, dilo y entrega ambos para una prueba en lugar de fingir que el linter puede distinguirlos. La puntuación es un lint, no una predicción.

La puerta

Nada de esto publica. Este skill escribe y tú publicas. Cada salida termina en un bloque que el usuario copia, y la última línea de cada ejecución es la pregunta: ¿Lo envías o lo cambias?

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Skills relacionados