Communitygithub.com

caption-writer

Crea titulares y textos que detienen el scroll, enganchan la atención y dirigen a la acción, adaptados a cada plataforma y objetivo.

¿Qué es caption-writer?

Caption Writer es una habilidad diseñada para redactar textos (captions) que no se limitan a describir una publicación, sino que la potencian. Su principio fundamental es que la primera línea debe ganar el '…más' en cualquier plataforma, ya que es lo único visible antes del corte. La habilidad guía al usuario paso a paso: primero, cargar los perfiles de marca y voz; luego, definir cuatro entradas clave (plataforma, contenido visual, objetivo y tema); después, elegir un formato y una estructura basada en el objetivo (awareness, comentarios, guardados, clics, comunidad o conversión); finalmente, redactar la primera línea con especial cuidado, construir el cuerpo con una única llamada a la acción y aplicar las normas mecánicas de cada plataforma. Además, ofrece un control de calidad integrado y maneja casos extremos como publicaciones sin descripción del contenido, múltiples plataformas, marcas reguladas o formatos de carrusel. Está diseñada para ser usada por agentes de IA en plataformas como Claude Code, Cursor o Codex, y se complementa con otras habilidades como brand-profile, voice-builder, hook-writer, y cross-platform-repurposing.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/social-media-skills/skills/tree/main/skills/caption-writer

Preguntar en tu IA favorita

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

Documentación

Caption Writer

Un caption no es una descripción de la publicación. Es la parte de la publicación que hace el trabajo: detiene el scroll, gana atención y dirige una acción. Bien hecho, sostiene la publicación; hecho genéricamente, hunde incluso grandes visuales bajo ruido de emojis y hashtags.

Dos principios guían todo esto:

  1. La primera línea lo es todo. En cada plataforma el caption se trunca: el lector ve una línea y un "…más". Si esa línea no gana el toque, el resto nunca se lee. Escribe la primera línea como si su único trabajo fuera ganar la segunda línea.
  2. Cada caption sirve a un objetivo. Awareness, comentarios, guardados, clics, comunidad o conversión: el objetivo dicta la estructura y la llamada a la acción. Un caption "para obtener engagement" es un caption sin objetivo.

Paso 0: Lee primero los fundamentos (obligatorio)

Carga brand-profile.md y voice.md antes de escribir una palabra. La huella vocal, la lista "nunca" y las barreras de marca son innegociables. Un caption que no suene a ellos es un fracaso, incluso si es ingenioso. Si ninguno existe, ejecuta primero brand-profile (y voice-builder si hay muestras).

Paso 1: Establece cuatro entradas

No escribas hasta que sepas esto. Infiere lo que puedas; pregunta solo lo que no puedas:

  • Plataforma — las mecánicas son diferentes en cada una (ver references/platforms.md).
  • El contenido — ¿qué hay en la foto/video/carrusel? El caption complementa lo visual; no debe narrar lo que el ojo ya ve.
  • El objetivo — awareness, comentarios, guardados, clics/tráfico, comunidad o conversión.
  • El tema / punto — de qué trata esta publicación específica y la única idea que transmite.

Si el usuario solo te da "escribe un caption para esto", haz como máximo una o dos preguntas (generalmente plataforma + objetivo) y continúa.

Paso 2: Elige el formato, luego la estructura basada en el objetivo

Elige el formato del caption que se ajuste al contenido y al punto: historia, valor/cómo se hace, postura polémica, pregunta, detrás de escenas, prueba social, anuncio, relatable (ver references/formats.md). Luego dale forma con la estructura basada en el objetivo y la CTA de references/frameworks.md. El formato le da una forma reconocible; el objetivo le da un trabajo.

Paso 3: Escribe la primera línea primero

Dedica un esfuerzo desproporcionado aquí. Redacta de 3 a 5 líneas de apertura candidatas y elige la que más haga que un desconocido necesite la siguiente línea, dentro del límite de vista previa de la plataforma. Nunca desperdicies la primera línea en un saludo, un hashtag, "¡Feliz lunes!" o una repetición de la imagen. Ver references/first-line.md.

Paso 4: Construye el cuerpo y una sola CTA

  • Cuerpo: entrega el valor o la historia que prometió la primera línea, con la voz de la marca, en la longitud adecuada para la plataforma y el objetivo (lo corto no siempre es mejor — ajústalo). Usa saltos de línea y espacios en blanco donde la plataforma recompense la escaneabilidad.
  • CTA: exactamente una, alineada con el objetivo ("guarda esto para tu próximo lanzamiento", "¿qué añadirías?", "link en bio"). Dos CTA dividen la acción y matan ambas. Respeta cualquier barrera de "nunca vender aquí" del perfil de marca.

Paso 5: Mecánicas: hashtags, enlaces, formato

Aplica las normas actuales de la plataforma desde references/platforms.md: cuántos hashtags (y si usar alguno), dónde van los enlaces y si afectan el alcance, la representación de saltos de línea y la longitud ideal. Equivocarse en las mecánicas hace que un buen caption rinda menos.

Paso 6: Entrega opciones, recomienda una

Dale al usuario 2 o 3 opciones de caption distintas (ángulos o formatos genuinamente diferentes, no el mismo caption reformulado), luego recomienda una con una justificación de una línea vinculada al objetivo. La gente elige más rápido entre alternativas reales que con una sola opción.

Control de calidad: autoverificación antes de entregar

  • ¿La primera línea detiene el scroll por sí sola, dentro del límite de vista previa?
  • ¿Suena a ellos — huella vocal acertada, lista "nunca" respetada, palabras prohibidas ausentes?
  • ¿Hay una CTA clara alineada con el objetivo?
  • ¿El caption complementa el contenido en lugar de describirlo?
  • ¿Los hashtags/enlaces/longitud son correctos para la plataforma?
  • ¿Una persona real se detendría, leería y actuaría — o se desplazaría?

Si la primera línea es débil, reescríbela antes que cualquier otra cosa. Es el 80% del resultado.

Casos extremos

  • Sin contenido descrito: pregunta qué hay en él, o escribe un caption que funcione para el tema indicado y señala que la primera línea puede necesitar ajustes al visual.
  • Múltiples plataformas solicitadas: no pegues el mismo caption en todas partes. Adapta el gancho, la longitud, los hashtags y la CTA a las mecánicas de cada plataforma (ver cross-platform-repurposing para hacerlo a escala).
  • Marca regulada/sensible: aplica las barreras de cumplimiento del perfil de marca — sin afirmaciones prohibidas, descargos requeridos, CTA cuidadosas.
  • Carrusel / multiimagen: el caption apoya el deslizamiento — la primera línea debe atraer a la gente hacia la diapositiva 1; considera un empujón "sigue leyendo / desliza" solo si encaja con la voz.
  • Objetivo basado en enlaces en una plataforma sin enlaces (p. ej., feed de Instagram): redirige a "link en bio" y dilo; no escribas una CTA de enlace clicable donde los enlaces no son clicables.
  • Plataformas de formato muy corto (X, Threads, Bluesky): el caption es toda la publicación — lidera con el punto, elimina todo lo demás.

Habilidades relacionadas

  • brand-profile, voice-builder — léelos primero; proporcionan voz y barreras.
  • hook-writer — para trabajo más profundo en el gancho de apertura.
  • linkedin-post-writer, thread-writer — copy especializado para formato largo/hilos.
  • hashtag-strategy — para un sistema de hashtags más completo.
  • cross-platform-repurposing — adapta un caption a varias plataformas.
  • scheduling-and-queue — envía el caption terminado a WoopSocial para programar.

Referencias

  • references/platforms.md — mecánicas de caption por plataforma (límites, pliegue, hashtags, enlaces).
  • references/frameworks.md — estructura de caption, mapeo objetivo→estructura, longitud, biblioteca de CTA.
  • references/formats.md — formatos/arquetipos de caption y cuándo usar cada uno.
  • references/first-line.md — arte de la línea de apertura; ganar el toque "…más".
  • references/examples.md — captions trabajados en distintas plataformas y objetivos.

Individual skills in this repo

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

Skills relacionados