imMamdouhaboammar/writing-style-hack

Writing Style Hack — Guía Universal de Escritura Multi-Agente

Entrena y guía a cualquier agente de IA (Claude Code, Google Antigravity, Gemini CLI, OpenAI Codex, Cursor, OpenCode) para que escriba con una voz humana auténtica, ganchos convincentes y formatos nativos de cada plataforma.

---

⚡ Enrutamiento Dinámico y Jerarquía del Skill

Sigue siempre la jerarquía de dos niveles:

1. Motor Fundamental de Copywriting: Se aplica a TODA escritura, independientemente del formato.
2. Anulaciones Específicas de Plataforma: Las reglas de la plataforma siempre prevalecen sobre las reglas fundamentales cuando hay conflicto.

                    ┌─────────────────────────────────┐
                    │      Prompt del Usuario        │
                    └────────────────┬────────────────┘
                                     │
                                     ▼
                    ┌─────────────────────────────────┐
                    │  Núcleo Fundamental de Copy     │
                    │   (Claridad, Especificidad, Voz) │
                    └────────────────┬────────────────┘
                                     │
           ┌─────────────────────────┼─────────────────────────┐
           ▼                         ▼                         ▼
 ┌──────────────────┐      ┌──────────────────┐      ┌──────────────────┐
 │   Newsletters    │      │    X (Twitter)   │      │     LinkedIn     │
 │ Ganchos          │      │ 5 fórmulas de    │      │ Liderazgo B2B,   │
 │ narrativos,      │      │ gancho viral,    │      │ anuncios,        │
 │ vulnerabilidad   │      │ corto vs. largo  │      │ contratación     │
 └─────────┬────────┘      └─────────┬────────┘      └─────────┬────────┘
           │                         │                         │
           └─────────────────────────┼─────────────────────────┘
                                     ▼
                           ┌──────────────────┐
                           │     YouTube      │
                           │ Guiones, 3       │
                           │ títulos y 3      │
                           │ miniaturas       │
                           └─────────┬────────┘
                                     │
                                     ▼
                    ┌─────────────────────────────────┐
                    │  Copia Verificada de Alta       │
                    │  Conversión                     │
                    └─────────────────────────────────┘

---

1. Principios Fundamentales de Copywriting

Cada pieza de contenido debe respetar estos 4 principios básicos:

1. Claridad sobre Ingenio: Si tienes que elegir entre un juego de palabras creativo y una comprensión cristalina, elige siempre lo claro.
2. Beneficios sobre Características: Enfócate en la transformación tangible o el resultado para el lector, nunca en meras descripciones de capacidades.
3. Especificidad sobre Vaguedad: Números concretos, plazos y métricas superan a las afirmaciones abstractas. ("Ahorra 3 horas cada semana" vence a "ahorra tiempo valioso").
4. Lenguaje del Cliente sobre Jerga Corporativa: Escribe como hablan los profesionales inteligentes mientras toman un café. Elimina las palabras de moda.

Vocabulario Prohibido y Palabras de Moda

• Nunca escribas: "utilizar", "facilitar", "iniciar", "optimizar", "apalancar", "sinergia", "revolucionar", "cambio de juego", "profundizar", "tejido", "testimonio".
• Reemplázalos con: "usar", "ayudar", "comenzar", "mejorar", "reducir", "mostrar", "construir".

Reglas de Voz y Ritmo

• Voz Activa: Escribe "Nosotros diseñamos este sistema" en lugar de "Este sistema fue diseñado".
• Recorte Despiadado: Elimina calificadores débiles ("muy", "realmente", "solo", "en realidad", "literalmente").
• Párrafos Cortos: Máximo 1–3 oraciones por párrafo. Usa párrafos de una sola oración para destacar puntos clave.
• Fórmula de CTA: [Verbo de Acción] + [Lo Que Obtienen] + [Calificador].
  • ✅ Bueno: "Comienza mi prueba gratis", "Obtén la lista de verificación completa", "Únete a más de 10,000 suscriptores".
  • ❌ Malo: "Enviar", "Haz clic aquí", "Aprende más".

---

2. Especialistas por Plataforma

A. Especialista en Newsletters (Newsletters/)

• Archivo Principal: Newsletters/newsletter-writer-skill.md
• Ejemplos Exitosos: Newsletters/Successful Posts/
• Voz: Conversacional, íntima, auténticamente vulnerable. Comparte dudas honestas, fracasos y anécdotas personales.
• Estructura Base:
  1. Gancho de Apertura: Afirmación audaz, giro personal o planteamiento provocador.
  2. El Cambio: Contrasta la forma antigua con la nueva realidad.
  3. Lo Que Construí / Lo Que Encontré: Evidencia concreta, capturas de pantalla o métricas.
  4. La Lección / El Marco: Desglose paso a paso y aplicable.
  5. La Invitación: Llamada a la acción conversacional de baja fricción.

B. Especialista en X / Twitter (X/)

• Archivo Principal: X/x-writer-skill.md
• Ejemplos Exitosos: X/Successful Posts/
• Dos Formatos:
  • Forma Corta: Gancho (<280 caracteres) + viñetas de valor + CTA única y contundente.
  • Análisis en Forma Larga: Desglose profundo con encabezados modulares y código/arquitectura paso a paso.
• 5 Fórmulas de Gancho Probadas:
  1. Punto de Dolor: "Los gráficos en movimiento siempre fueron lo más difícil de hacer videos para mí..."
  2. Contrario: "Soy ingeniero graduado de Carnegie Mellon, pero aún así elegí usar Lovable para construir esto."
  3. Escala / Números: "Reduje nuestro gasto en un 98%." / "Diferencia de 216x. La misma app. La misma demo. Diferente gancho."
  4. "Espera, ¿qué?": "¿cómo es esto legal?" (Generó 10.2M de visitas).
  5. Afirmación Audaz: "El Enjambre Ha Llegado. Esta es la primera vez que veo la arquitectura funcionar en la práctica."

C. Especialista en LinkedIn (Linkedin Successful Posts/)

• Archivo Principal: Linkedin Successful Posts/linkedin-writer-skill.md
• Ejemplos Exitosos: Linkedin Successful Posts/Successful Posts/
• Audiencia: Ejecutivos B2B, fundadores, reclutadores y constructores ambiciosos.
• 4 Arquetipos Probados:
  1. Liderazgo de Pensamiento / Cambio en la Industria: Cuestiona el statu quo con una tesis fundamentada.
  2. Anuncio de Producto: Comienza con la transformación del cliente, seguido de pares de características y beneficios numerados.
  3. Contratación y Escalado: Limitaciones transparentes, misión emocionante, números reales.
  4. Detrás de Escena / "Muestra tu Trabajo": Lecciones operativas transparentes.
• Regla de Diseño: Doble salto de línea entre ideas para una lectura móvil sin esfuerzo.

D. Especialista en Guiones de YouTube (Youtube posts/)

• Archivo Principal: Youtube posts/youtube-outline-skill.md
• Ejemplos Exitosos: Youtube posts/Successful Scripts/
• Entregables Requeridos para Cada Solicitud:
  1. Esquema del Video: Gancho (0:00-1:00) → Promesa → Preparación (1:00-3:00) → Contenido Principal (80%) → Conclusión y Adelanto.
  2. 3 Opciones de Título Atractivas: Ganchos variados (intriga, resultado extremo, contrario).
  3. 3 Conceptos de Miniatura: Descripciones visuales que se combinen con las opciones de título.

---

3. Flujo de Trabajo de Generación Paso a Paso

Al generar contenido con este skill:

1. Clasifica la Plataforma: Determina si el resultado es Newsletter, X, LinkedIn, YouTube, o Copia General.
2. Selecciona Arquetipo y Gancho: Elige una de las fórmulas de gancho verificadas que coincida con el tema.
3. Redacta con Revelación Progresiva:
   • Entrega el valor más fuerte en el 20% inicial.
   • Inyecta números específicos, nombres o métricas reales.
   • Mantén un ritmo conversacional (1–3 oraciones por párrafo).
4. Aplica el Formato: Espaciado doble, subtítulos escaneables, viñetas contundentes.
5. Lista de Verificación de Calidad:
   • Sin palabras de moda corporativas ni frases de relleno de IA.
   • Beneficios expresados antes que características.
   • CTA actionable presente.
   • Tono calibrado para la plataforma objetivo.