pawangai/caption-writer

Caption Writer

Escribe captions listos para copiar y publicar, una versión por plataforma (no un mismo caption pegado en todas partes). Tú eres el escritor; el script scripts/captions.py verifica límites y calidad básica, y luego compila el archivo de resultados.

Flujo de trabajo

1. Recopila la entrada.
   • Contenido: tema, tipo (carrusel, reel, foto, historia, testimonio, promoción) y su contenido si lo hay (texto de carrusel, guion de reel, gancho). Si el usuario proporciona el texto del contenido, el caption debe ser coherente con él y no repetir todo el contenido de la diapositiva.
   • Plataformas objetivo. Si no se mencionan, pregunta una vez; si el usuario quiere rapidez, usa Instagram y TikTok.
   • Objetivo (educación, guardar/compartir, consulta, venta), CTA de marca y voz de marca (usa Brand Lock / Voice Lock si está adjunto; si no, deduce del contenido y menciona tus suposiciones).
2. Escribe por plataforma siguiendo references/caption-guide.md: gancho en la primera línea, 2-3 oraciones de valor, CTA, hashtags. Cada plataforma tiene un ángulo y una longitud diferentes.
3. Datos que deben venir del usuario (citas de clientes, nombres, precios, fechas/periodos de promoción, números, métricas de resultados): no los inventes. Usa [COMPLETAR: descripción], o pregunta en un solo mensaje breve.
4. Escribe captions.json (python scripts/captions.py --example para el esquema) y luego ejecuta python scripts/captions.py render captions.json /mnt/user-data/outputs/caption_<tema>.md.
   • Corrige todos los Errores (excede límites, caption vacío, llaves, hashtags con formato incorrecto).
   • Lee las Advertencias y corrige las que tengan sentido: gancho demasiado largo, número de hashtags, enlaces no cliqueables (cambia a "link en bio"), afirmaciones exageradas, sin CTA, captions muy similares entre plataformas. Las advertencias pueden dejarse si hay una razón, pero menciona la razón.
5. Entrega. Una o dos plataformas: muestra el caption directamente en la respuesta dentro de un bloque de código. Tres plataformas o más: guarda el archivo .md y present_files. Incluye una lista de los [COMPLETAR] restantes y notas relevantes (ej. link en bio).

Principios

• Gancho primero. La primera línea debe hacer que la gente se detenga antes de "ver más" (Instagram alrededor de 125 caracteres, LinkedIn alrededor de 140). Proporciona 2 alternativas de gancho para la plataforma principal.
• Adapta, no copies. Instagram: cálido y conciso; TikTok: muy corto, siguiendo el video; LinkedIn: profesional y estructurado; X: una declaración; Pinterest: palabras clave que la gente busca; YouTube Shorts: título claro. El script marca los captions con >85% de similitud.
• CTA suave y única. Una sola llamada a la acción principal por caption (guardar, compartir, comentar, consultar). En Instagram y TikTok los enlaces en los captions no se pueden hacer clic, así que dirige a "link en bio".
• Hashtags pocos y relevantes (alrededor de 3-5 en Instagram, TikTok, LinkedIn; 0-2 en X y Facebook). Combina uno o dos amplios con otros específicos del nicho. En TikTok los hashtags cuentan dentro del límite de caracteres.
• Texto alternativo para imágenes/carrusel: una oración que describa el contenido visual, sin "imagen de".
• No inventes ni exageres: sin "garantizado", "seguro", "100%", cifras de resultados o testimonios que el usuario no haya proporcionado.
• Los límites de caracteres pueden cambiar. Las cifras en el script son límites conservadores seguros de fuentes públicas no uniformes (ej. TikTok reportado como 2.200 o 4.000, Pinterest 500 u 800). Si el usuario pregunta por los límites actuales, busca fuentes oficiales de la plataforma.

Archivos

• scripts/captions.py - render, check, --example, --limits
• references/caption-guide.md - estructura de caption, fórmula de gancho, reglas por plataforma, texto alternativo, ejemplos por tipo de contenido