Escribir Copy (ganchos · guion · pie de foto)
El cuello de botella creativo no es generar medios, sino saber qué decir. Esta skill genera ganchos, guiones y pies de foto utilizando marcos probados de respuesta directa, y luego permite al usuario elegir y refinar. Respaldado por comandos de flujo de trabajo — llama a la CLI, no escribas un script:
node workflows/cli.cjs generateHooks '<json-args>' # también: generateScript, generateCaption
Las firmas de llamada de TypeScript que se muestran a continuación documentan los argumentos de cada comando — tradúcelos en node workflows/cli.cjs <comando> '<json-args>', no los pegues en un archivo nuevo.
Obtén el contexto del proyecto primero cuando exista (project.md audiencia/puntos débiles/oferta; brand.md tono/restricciones) para que el copy sea fiel a la marca y nunca infrinja las restricciones.
PASO 0: Verificar el copy de referencia ANTES de escribir nada
La consistencia de la voz proviene de ejemplos, no de adjetivos. Antes de generar ganchos, guiones o pies de foto:
- Verifica el registro para ver ejemplos de copy guardados:
Si se encuentran → extrae los patrones (longitud de oraciones, uso de emojis, estilo de hashtags, fraseo de CTA, formalidad) y REFLÉJALOS en todo lo que escribas a continuación.node workflows/cli.cjs resolveAsset '["{nombre}","style-copy"]' # un id de style_references que contiene ejemplos de copy cat projects/{nombre}/assets/style/copy-examples.md 2>/dev/null cat projects/{nombre}/style-samples/caption-examples/*.md 2>/dev/null # bandeja de entrada del usuario - Nada guardado → pregunta una vez:
"¿Tienes publicaciones, pies de foto o guiones anteriores que hayan funcionado bien? ¿O cuentas cuyo estilo de copy te guste? Pega 1-3 ejemplos (o 'ninguno' — me basaré en brand.md)."
- Si se dan ejemplos → guárdalos en
projects/{nombre}/assets/style/copy-examples.mdy regístralos (registerAsset '["{nombre}","style_references",...]') para que piezas futuras los reutilicen. - "ninguno" → continúa desde el tono de
brand.mde indica qué suposiciones de tono hiciste.
- Si se dan ejemplos → guárdalos en
- Cuando existan ejemplos, anota en
prompts.txta qué referencia se emparejó el copy.
PASO 1: Ganchos (elige el ángulo antes de escribir todo)
Genera una variedad de ganchos en diferentes ángulos y deja que el usuario elija 1-2 para desarrollarlos.
node workflows/cli.cjs generateHooks '{"topic":"App planificador de estudio con IA","audience":"estudiantes universitarios preparándose para finales","painPoint":"no saber por dónde empezar a repasar","platform":"tiktok","count":8}'
# h.data.hooks: [{ text, angle }] — ángulos: problema | curiosidad | resultado | contrapunto | pregunta | estadística | historia
Muéstralos agrupados por ángulo y pregunta cuál usar. No elijas automáticamente — el gancho decide toda la pieza.
PASO 2: Guion (basado en marcos, ajustado a la duración)
Una vez elegido el gancho, escribe el guion con un marco que se adapte al objetivo:
| Marco | Mejor para |
|---|---|
hook-retain-reward | video de formato corto (TikTok/Reels/Shorts) — predeterminado |
PAS (Problema-Agitación-Solución) | anuncios basados en dolor |
AIDA (Atención-Interés-Deseo-Acción) | respuesta directa clásica |
BAB (Antes-Después-Puente) | transformación / resultados |
historia-estrella-solución | testimonios / historia del fundador |
# gancho: pasa el texto del gancho elegido de generateHooks
node workflows/cli.cjs generateScript '{"brief":"Planificador de estudio con IA que crea un horario de repaso en 60 segundos","framework":"PAS","platform":"tiktok","durationSeconds":30,"hook":"<texto del gancho elegido>","cta":"Pruébalo gratis — enlace en la biografía"}'
# s.data: { framework, sections:[{label, voiceover, visual}], wordCount, estimatedDurationSeconds }
Muestra el guion como secciones etiquetadas (voz en off + pista visual) y la duración estimada.
Indica si estimatedDurationSeconds está lejos del objetivo para que el usuario pueda recortar/ampliar.
Este texto de voz en off se alimenta directamente de generateVoiceover() y las pistas visuales visual por escena alimentan generateStoryboard() / la skill de video.
PASO 3: Pie de foto (listo para publicar, por plataforma)
El último paso — el texto de la publicación + hashtags que realmente acompañan al video/imagen.
node workflows/cli.cjs generateCaption '{"topic":"App planificador de estudio con IA","platform":"instagram","tone":"amigable y seguro","cta":"Enlace en la biografía","count":3}' # platform: tiktok | instagram | youtube | facebook
# c.data.captions: [{ text, hashtags:[] }]
Genera variantes por plataforma si la pieza se publica en varias (cada plataforma tiene normas diferentes de longitud y hashtags). Guarda el pie de foto elegido junto al resultado, por ejemplo projects/{nombre}/output-contents/.../caption.md.
Cómo se conecta
generateHooks → elegir → generateScript → { voz en off → generateVoiceover,
pistas visuales → generateStoryboard → video }
→ generateCaption → caption.md
Siempre sugiere y confirma — presenta opciones, recomienda una con un motivo, permite que el usuario edite. Nunca fabriques estadísticas/testimonios (extrae solo los reales de project.md).