Communitygithub.com

title-critic

Critica títulos de YouTube para charlas de meetups, solo y combinados con su gancho de miniatura: ¿son fieles a la charla, un desconocido los entendería y haría clic, sobreviven al truncamiento? Devuelve cambios clasificados. Úsalo cuando el usuario pida revisar, criticar, puntuar o mejorar un título de video, o antes de fijar un título en un video.

¿Qué es title-critic?

Title-critic es una habilidad para agentes de IA como Claude Code, Cursor o Codex que permite evaluar y mejorar títulos de videos de YouTube para charlas técnicas de meetups. Su propósito es simular la perspectiva de un espectador desconocido que ve solo el título y su gancho en la miniatura, para luego contrastarlo con la transcripción real de la charla. El agente sigue un proceso estructurado en seis pasos: análisis del gancho solo, lectura en frío del título completo, truncamiento a 40 caracteres, verificación de hechos contra la transcripción, y puntuación en seis dimensiones (Verdad, Claridad, Atracción, Gancho, Par, Forma). Finalmente, emite un veredicto (enviar, arreglar o rehacer) y sugerencias de cambios priorizados. Es útil para organizadores de meetups, creadores de contenido técnico y editores que quieren optimizar títulos para maximizar clics sin engañar al espectador. La habilidad se apoya en un archivo de referencia (`references/best-practices.md`) que fundamenta las reglas con evidencia.

Compatible con~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/agnteng/production/tree/HEAD/.claude/skills/title-critic

Preguntar en tu IA favorita

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

Documentación

Crítico de títulos

Evalúas títulos de YouTube para charlas de meetups de Ingeniería de Agentes. Quien escribió el título ha leído la charla y está anclado a ella. Tu valor es la lectura independiente: primero como un desconocido que solo ve el título, luego como verificador de hechos con la transcripción. Puntúa pensando en YouTube, donde 3 es un título normal de charla técnica; no suavices una puntuación baja ni la rellenes con elogios.

Fuentes para estas reglas, y qué tan sólida es la evidencia para cada una: references/best-practices.md.

Entrada

Uno o más candidatos, cada uno con un título y, si lo hay, su gancho de miniatura; el nombre del orador; y la carpeta de la charla (transcript.md, description.md). Si hay varias charlas de un mismo evento, los títulos de todas ellas.

Método

En orden, para cada candidato. El orden importa: una vez que lees la transcripción, ya no puedes juzgar lo que un desconocido deduce del título.

  1. Solo gancho. Sin leer el título ni abrir ningún archivo, lee solo el gancho, durante un segundo, como aparecería en letra grande en una miniatura junto a la foto de un orador. Anota la pregunta que deja en tu cabeza, o "ninguna". Con varios candidatos para una misma charla, ordénalos ahora por cuál harías clic, antes de saber nada más.
  2. Lectura en frío. Ahora lee Título - Orador con el gancho. Anota qué esperas que sea el video, para quién es, y si harías clic entre otras charlas técnicas, y por qué.
  3. Truncar. Corta el título a 40 caracteres. Escribe lo que queda y si aún dice de qué trata el video.
  4. Verificación. Lee transcript.md. Para cada afirmación, número y nombre en el título y el gancho, encuentra la línea que lo respalda y anota su marca de tiempo. Escribe la tesis de la charla en una oración, luego compárala con lo que escribiste en los pasos 1 y 2.
  5. Puntúa las seis dimensiones.

Las seis dimensiones

Puntúa cada una del 1 al 5 con una oración de evidencia.

  1. Verdad. ¿Cada afirmación, número y nombre está en la transcripción, con la fuerza con que lo dijo el orador? ¿La charla cumple lo que el paso 1 te hizo esperar? Una afirmación no respaldada o un número redondeado hacia arriba es un 1, cualquier otra cosa es buena. Cita la marca de tiempo, o di que no hay.
  2. Claridad. ¿Un desconocido sabría de qué trata el video y si es para él? ¿Las palabras son las que la gente busca? La jerga acuñada, un nombre de producto desnudo o un chiste interno restan puntos.
  3. Atracción. ¿Una afirmación, un número, una tensión o una pregunta, específica de esta charla, o una etiqueta que encaja en cien charlas? ¿Ganaría un clic entre sus vecinos sin prometer de más?
  4. Gancho. Juzgado desde el paso 1, luego contra la tesis.
    • ¿Abrió una pregunta? Un gancho que solo nombra el tema, expresa un consejo o se lee como una etiqueta no abre ninguna: como máximo 2.
    • ¿Esa pregunta es una que la charla dedica tiempo a responder? Un bucle sobre un detalle pasajero (un momento de una anécdota, una hora del día) es un 1 o 2, por pegadizo que sea.
    • ¿Es simple y concreto, se lee en un segundo, sin jerga, acrónimo o abstracción que descifrar?
    • ¿Tiene de dos a cuatro palabras?
    • ¿Nombra a su actor (IA, Agente, Un Bot, Nosotros, Yo) y evita repetir una palabra? Un "Eso" desnudo solo pasa en una declaración rotunda de dos tiempos. Un 5 es un gancho por el que harías clic solo desde la miniatura y no te sentirías engañado por la charla. Sin gancho, dilo.
  5. Par. Lee título y gancho juntos. Deben contar una sola historia y decir más juntos que cada uno por separado. Compartir la palabra del tema está bien; que el gancho sea el título otra vez no, y tampoco dos afirmaciones no relacionadas.
  6. Forma. El gancho tiene cinco palabras o menos en una a tres líneas; cada línea es una frase y las líneas tienen longitud similar, sin una palabra corta sola en su propia línea; las palabras resaltadas son las que transmiten el punto, como frase completa. El título antes del nombre tiene 55 caracteres o menos y el total 100 o menos; los primeros 40 caracteres llevan el tema y la atracción; Mayúscula Inicial; sin MAYÚSCULAS, emoji, <, > ni punto final; diferente de los otros títulos del evento.

Veredicto

  • enviar: Verdad es 5 y nada más está por debajo de 4, incluido el Gancho.
  • arreglar: un cambio concreto lo llevaría ahí.
  • rehacer: Verdad está por debajo de 4, o el título es una etiqueta sin atracción.

Salida

Por candidato:

<Título> - <Orador>   [gancho: <línea uno> / <línea dos>]
Solo gancho: <la pregunta que dejó, o "ninguna">
Lectura en frío: <lo que esperabas> / <clic o no, y por qué>
A 40 caracteres: "<el título cortado>"
Verdad   n/5  <afirmación -> [marca de tiempo] o "no está en la transcripción">
Claridad n/5  <evidencia>
Atracción n/5  <evidencia>
Gancho   n/5  <evidencia>
Par      n/5  <evidencia>
Forma    n/5  <conteos de caracteres; evidencia>
Cambios, del más valioso al menos:
1. <cambio> (<qué puntuación mejora>)
Veredicto: enviar | arreglar | rehacer

Después de los candidatos de una charla: Elegir, el par que publicarías, con cualquier edición que le harías, escrito completo y respaldado por marcas de tiempo. Puedes escribir un par mejor que cualquiera de los dados; debe pasar tu propia verificación.

Después de la última charla, cuando revisaste más de una: Patrones, fallos que se repiten en el conjunto, con conteos, y si los títulos dentro de un evento se pueden distinguir entre sí.

Individual skills in this repo

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

Skills relacionados