Communitygithub.com

AlemTuzlak/skills

Usa esto cuando el usuario quiera metadatos de YouTube para un video: un título llamativo, una descripción SEO/above-the-fold, etiquetas y capítulos con marcas de tiempo. Acepta una transcripción (idealmente SRT con marcas de tiempo), un tema, un PR o una descripción libre. Se usa de forma independiente y con /produce-video. Se activa con "youtube title", "youtube description", "youtube chapters", "youtube tags", "youtube metadata", "youtube-copy".

¿Qué es skills?

Esta habilidad está diseñada para generar metadatos de YouTube optimizados para clics y posicionamiento: título, descripción, etiquetas y capítulos con marcas de tiempo. Se basa en una fuente proporcionada (transcripción con marcas de tiempo, tema, PR o descripción libre) y nunca inventa afirmaciones que la fuente no respalde. Es compatible con cualquier agente de IA que admita habilidades de archivo (como Claude Code, Cursor, Codex) y produce un archivo `youtube.md` estructurado. El título debe tener entre 60 y 70 caracteres, la descripción debe estar cargada al frente (primeros ~100-160 caracteres visibles) con el gancho y la palabra clave principal, las etiquetas deben ser de 5 a 15 y relevantes, y los capítulos requieren una fuente con marcas de tiempo (SRT o `words.json`) y deben comenzar en `00:00`. La habilidad incluye una regla estricta de no usar guiones largos (— o –), reemplazándolos por un guion corto (-) en todo el texto. Sigue un proceso de cuatro pasos: leer la fuente, identificar la palabra clave y el beneficio principal, redactar opciones de título y autoverificar contra las reglas. Enlaces de referencia a vidIQ y la ayuda de YouTube están incluidos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlemTuzlak/skills/tree/HEAD/skills/youtube-copy

Preguntar en tu IA favorita

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

Documentación

YouTube Copy

Escribe los cuatro elementos de metadatos de YouTube que generan clics y posicionamiento: título, descripción, etiquetas, capítulos. Basa todo en la fuente proporcionada (transcripción / tema) — nunca inventes afirmaciones que la fuente no respalde. Para los capítulos necesitas una fuente con marcas de tiempo (SRT o words.json); sin marcas de tiempo, pídelas o salta los capítulos.

Formato de salida

Escribe youtube.md (o imprime la misma estructura) exactamente así:

# YouTube

**Título**

<título>

**Descripción**

<descripción>

**Etiquetas**

#etiqueta1 #etiqueta2 #etiqueta3 ...

**Capítulos**

00:00 - <capítulo>
01:15 - <capítulo>
...

(Cuando /produce-video llame a esta habilidad, escribe youtube.md en la carpeta de salida.)

Regla de escritura (no negociable)

Nunca uses guiones largos (— o –). Usa un guion corto - en su lugar. Esto aplica al título, la descripción, los separadores de capítulos, todo.

Título (el elemento de mayor apalancamiento)

  • 60-70 caracteres (máximo estricto 100; cualquier cosa más allá de ~70 se trunca en la mayoría de las superficies).
  • Palabra clave principal cerca del inicio para que YouTube y los espectadores vean el tema de inmediato.
  • Haz las tres cosas: despierta curiosidad/emoción (sorpresa, urgencia, FOMO, beneficio), incluye la palabra clave y establece expectativas honestas (un título que sobrevende destruye el tiempo de visualización y es clickbait — evítalo).
  • Usa un número cuando sea natural (los números atraen la mirada) y palabras emotivas/poderosas ("en realidad", "finalmente", "detén", "la forma correcta", "type-safe", "sin").
  • Usa la jerga real de la audiencia, no frases genéricas.
  • Opcional: 1-2 hashtags relevantes solo si añaden descubrimiento; normalmente omítelos en el título.
  • Evita: cebo engañoso, spam con MAYÚSCULAS, groserías, >70 caracteres.
  • Fórmulas de inicio útiles (elige la que encaje, no fuerces): "Cómo hacer X (sin Y)", "La X que Y", "Deja de hacer X - haz esto en su lugar", "X explicado en N minutos", "Probé X para que no tengas que hacerlo", "N formas de hacer X".

Descripción

Estructura, cargada al frente (los primeros ~100-160 caracteres se muestran arriba del pliegue / en la búsqueda):

  1. Gancho (primeras 1-2 oraciones) que contenga la palabra clave principal — responde "¿qué es esto y por qué verlo?". Promete el resultado.
  2. Un párrafo corto (2-4 oraciones) que amplíe lo que el espectador aprende.
  3. Capítulos/marcas de tiempo (ver abajo) para videos > ~10 min (o cuando haya secciones claras).
  4. Enlaces/CTA opcionales (enlace principal, "ver después", suscribirse) — solo si el usuario los proporcionó; no inventes URLs.
  5. 2-3 hashtags relevantes al final.
  • Longitud: concisa y útil, aproximadamente 150-300 palabras / menos de ~1000 caracteres. Escribe para humanos; entrelaza palabras clave relacionadas de forma natural, nunca hagas relleno de palabras clave.

Etiquetas

  • 5-15 etiquetas, sin comas ni espacios por etiqueta (no se requiere que no haya espacios dentro de una etiqueta de varias palabras, pero mantenlas limpias).
  • Palabra clave principal/frase primero, luego una mezcla de amplias (ej. react, webdev) y específicas (ej. react router loader data, unstable_useRouteLoaderData).
  • Calidad sobre cantidad; todas las etiquetas deben describir genuinamente el contenido. Sin etiquetas no relacionadas/de spam, sin nombres de competidores.
  • Escríbelas con el prefijo # en youtube.md para legibilidad (se ingresan sin # en el cuadro de etiquetas de YouTube).

Capítulos (necesitan una fuente con marcas de tiempo)

Reglas estrictas de YouTube: el primer capítulo debe ser 00:00, al menos 3 capítulos en orden ascendente, cada capítulo de al menos 10 segundos de duración.

  • Primer capítulo (00:00) responde "¿por qué hicieron clic?" — nómbralo como el beneficio/tema (ej. "Datos de loader type-safe", "El resultado final"), NO "Introducción".
  • Títulos: 3-8 palabras, una frase nominal clara (el móvil corta los largos). Reemplaza etiquetas inútiles ("Introducción", "Demostración", "Conclusión", "Preguntas y respuestas") con el tema real de esa sección.
  • Frecuencia: aproximadamente cada 2-4 minutos para tutoriales, 5-10 minutos para formato largo; apunta a 5-15 capítulos en total, nunca más de ~20.
  • Deriva cada inicio MM:SS de la fuente con marcas de tiempo (el momento en que esa sección realmente comienza). Usa MM:SS (o H:MM:SS después de una hora). El separador es - (un guion corto), nunca un guion largo.

Proceso

  1. Lee la fuente. Si es un SRT/words.json, usa las marcas de tiempo para los capítulos; si es texto plano o un tema, escribe título/descripción/etiquetas y nota que los capítulos necesitan una fuente con marcas de tiempo.
  2. Identifica la palabra clave principal/tema (lo que alguien buscaría) y el beneficio (por qué harían clic).
  3. Redacta 2-3 opciones de título, elige la más fuerte según las reglas anteriores, luego escribe descripción, etiquetas, capítulos.
  4. Autoverifica: título <= 70 caracteres y con la palabra clave al inicio; el gancho de la descripción tiene la palabra clave en la primera oración; etiquetas 5-15 y relevantes; capítulos comienzan en 00:00, ascendentes, >=3, descriptivos; sin guiones largos en ninguna parte.

Referencias

Individual skills in this repo

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

AlemTuzlak/skills

Use when the user wants to write a blog post about a feature, product change, PR, git diff, or any technical topic - accepts marketing briefs, PRs, git refs, codebase paths, or freeform descriptions as input

AlemTuzlak/skills

Use when the user wants to generate a changelog, release notes, or document what changed between versions, tags, or PRs

AlemTuzlak/skills

Use when writing, editing, or organizing documentation, when planning what docs a feature needs, and whenever planning or implementing a new feature or change in a repo (docs ship with the code). Also use when tempted to write docs without showing the discovered readers to the user, without asking for tone, or without loading simple-english and i-have-adhd. Triggers on "write docs for X", "document this feature", "add a guide", "update the docs", "reorganize the docs", "plan feature X", "implement X", or /docs.

AlemTuzlak/skills

Use when a bug is in play: a test fails, CI is red, an API returns the wrong result, a stack trace appears, or the user says it is broken or fix this. Don't use for a new feature with no failure, for types-only work, or for docs.

AlemTuzlak/skills

Use when the user invokes /i-have-adhd, says they have ADHD, or asks for ADHD-friendly output. Also used as a required writing filter by the docs skill. Don't use for marketing copy or after the user says "stop adhd mode" or "normal mode".

AlemTuzlak/skills

Use when a settled change must be turned into an ordered stack of small blocks before anyone implements. Don't use for unsettled intent, typos, comments, formatting, docs-only work, or writing the implementation itself.

AlemTuzlak/skills

Use when the user wants to write a product update email, feature announcement newsletter, or digest email for users or subscribers

AlemTuzlak/skills

Use when the user wants to turn a raw talking-head / screen-share recording into a finished, edited, annotated video plus a full content package. Removes silences, flags mistakes for the user to cut, transcribes, adds transcript-synced overlays (code, on-screen code highlights, word highlights, lists, comparisons, diagrams, section labels, punch-in zooms), renders with original audio, then generates blog/socials/YouTube content. Triggers on "produce a video", "edit my video", "annotate my recording", "/produce-video".

AlemTuzlak/skills

Use when the user runs /prove-it or says prove it, prove the changes, show me in the browser, or asks to prove a UI or API change. Don't use only because the agent is about to say done, for types-only work, or for docs with no behavior to prove.

AlemTuzlak/skills

Use when the user wants to write, draft, or author an RFC (Request for Comments) / technical design doc for a feature, change, or architectural decision. Interactively interviews the user, grounds the proposal in the actual codebase, presents 2-3 concrete API/code-snippet approaches to choose from, then writes a review-ready RFC. Triggers on "write an RFC", "draft an RFC", "RFC for X", "design doc for X", or /rfc.

AlemTuzlak/skills

Use when the user wants to deeply learn a new topic from scratch. Runs a pre-interview (current knowledge, end-goal proficiency, depth, practice load, background, scope), researches online (articles, niche-influencer blogs, canonical docs, subtopic landscape), then produces a structured markdown course with mandatory visual diagrams, evidence-based learning-science features (retrieval practice, spaced callbacks, worked-example fading, concept ledger, jargon gate, analogy hygiene), and a self-contained interactive HTML mini-course. Triggers on /teach-me, "teach me about X", "I want to learn X", "deep dive on X", "create a course on X", "study X with me".

AlemTuzlak/skills

Use when the change intent is already settled and the agent must map what a behavior change touches before an implementation plan or any code. Use for new features, bug fixes, and refactors that move a boundary. Don't use for typos, comments, formatting, lockfile-only diffs, docs with no code, or while the user is still deciding what they want.

AlemTuzlak/skills

Use when the user wants to transcribe a video or audio file to text with word-level timestamps — spins up a self-contained local Whisper (whisper.cpp) Docker service bundled in this skill and returns transcript.txt, transcript.srt, and word-level transcript.words.json. Also used as a building block by /produce-video. Triggers on "transcribe this video", "get a transcript", "transcribe-video".

AlemTuzlak/skills

Use when the user wants to write a video script for a product demo, feature walkthrough, launch video, or social media video about a feature or product change

Skills relacionados