Communitygithub.com

minkhant1996/soemind-forge

Escribe las palabras — ganchos que detienen el scroll, guiones basados en marcos y pies de foto listos para publicar con hashtags. Úsalo cuando el usuario necesite ideas de ganchos, un guion de video/anuncio, texto publicitario, pies de foto o diga «qué debería publicar», «escribe un guion», «dame ganchos», «escribe el pie de foto».

¿Qué es soemind-forge?

Esta skill de agente de IA está diseñada para eliminar el cuello de botella creativo en la generación de contenido escrito, ayudando a los usuarios a producir ganchos, guiones y pies de foto listos para publicar. Utiliza marcos probados de respuesta directa para generar opciones que el usuario puede seleccionar y refinar. Funciona principalmente a través de comandos de CLI definidos en un flujo de trabajo de Node.js, asegurando que las acciones sean ejecutables directamente sin necesidad de escribir scripts adicionales. La skill prioriza la consistencia de la voz de la marca al extraer ejemplos de copy de referencia de un registro o preguntar al usuario, y luego refleja esos patrones en el contenido generado. Soporta plataformas como TikTok, Instagram, YouTube y Facebook, ofreciendo variantes específicas para cada una. Está respaldada por comandos de flujo de trabajo que estructuran el proceso creativo en tres pasos: primero generar ganchos, luego un guion basado en un marco adecuado (como PAS, AIDA, BAB) y finalmente un pie de foto con hashtags, todo ello con confirmación del usuario en cada etapa para evitar fabricaciones.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/minkhant1996/soemind-forge/tree/HEAD/skills/write-copy

Preguntar en tu IA favorita

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

Documentación

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:

  1. Verifica el registro para ver ejemplos de copy guardados:
    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
    
    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.
  2. 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.md y regístralos (registerAsset '["{nombre}","style_references",...]') para que piezas futuras los reutilicen.
    • "ninguno" → continúa desde el tono de brand.md e indica qué suposiciones de tono hiciste.
  3. Cuando existan ejemplos, anota en prompts.txt a 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:

MarcoMejor para
hook-retain-rewardvideo 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óntestimonios / 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).

Skills relacionados