Communitygithub.com

october-academy/agnt

Guía de estrategia de landing pages — integración de VOC, 15+ fórmulas de titulares, anti-AI-slop. Se usa al planificar la estrategia de una landing page.

¿Qué es agnt?

Este skill proporciona una guía completa para diseñar landing pages que convierten, basada en insights de entrevistas y fórmulas de copywriting. Está diseñado para asistentes de IA como Claude Code, Cursor o Codex, y se integra a través de un archivo de estado (`state.json`) y referencias almacenadas localmente en directorios como `.claude/agnt`, `.codex/agnt` o sus versiones en el directorio home. El usuario define un problema, su cliente ideal (ICP) y una hipótesis; luego el skill lo guía paso a paso: recopila el contexto (VOC de entrevistas, especificaciones), determina el origen del tráfico, genera tres titulares basados en más de 15 frameworks de copywriting, diseña la estructura de 11 secciones, sugiere CTAs, aplica el modelo JTBD Four Forces, y verifica que el copy no tenga olor a IA (anti-AI-slop). También incluye un benchmark de conversión y un sistema de verificación de calidad llamado Seven Sweeps. Todo el proceso se documenta en `journey-brief.md` y se actualiza el estado para mantener la trazabilidad sin ejecutar acciones automáticas de despliegue.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/october-academy/agnt/tree/HEAD/skills/landing

Preguntar en tu IA favorita

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

Documentación

Guía de estrategia de landing pages. Utiliza insights de entrevistas y fórmulas de copywriting para diseñar landing pages que venden.

Determinación de la ruta de datos

AGNT_DIR

  1. Intenta leer .claude/agnt/state.json → si funciona, AGNT_DIR = .claude/agnt
  2. Si falla, intenta leer ~/.claude/agnt/state.json → si funciona, AGNT_DIR = ~/.claude/agnt
  3. Si falla, intenta leer .codex/agnt/state.json → si funciona, AGNT_DIR = .codex/agnt
  4. Si falla, intenta leer ~/.codex/agnt/state.json → si funciona, AGNT_DIR = ~/.codex/agnt
  5. Si ninguno existe → muestra "Primero comienza con /agnt:start." y termina.

REFS_DIR

Se determina verificando la existencia de {AGNT_DIR}/references/shared/navigator-engine.md.

Reglas de salida

La lógica interna (exploración de rutas, análisis de estado, búsqueda MCP) se ejecuta en silencio.

Procedimiento de ejecución

1. Verificación de condiciones previas

Lee {AGNT_DIR}/state.json.

  • meta.schema_version != 3 → guía al usuario a /agnt:start y termina.
  • project.problem == null → muestra "Primero define el problema con /agnt:discover." y termina.
  • artifacts.spec_versions < 1 → muestra "Puedes continuar sin SPEC, pero ordenarlo con /agnt:spec hará más claro el copy de la landing." (no obligatorio — se puede continuar).

2. Recopilación de contexto (integración VOC)

Lee desde el estado:

  • project.problem — el problema que se resuelve
  • project.icp — cliente ideal
  • project.hypothesis — hipótesis

Intenta leer el archivo SPEC: {AGNT_DIR}/specs/spec-v*.md (versión más reciente). Si no existe, continúa basándose en el estado.

Intenta leer {AGNT_DIR}/journey-brief.md.

  • Si existe la sección ## Interview, extrae insights de la entrevista (lenguaje del cliente, expresiones de dolor, descubrimientos sorprendentes).
  • Si existe la sección ## Audit, extrae información de la pista y el Insight Simplificador.
  • Si existe la sección ## Compete, extrae los resultados del análisis competitivo.

Reglas de uso de VOC (Voz del Cliente):

  • Usa en el copy las expresiones reales de los clientes que salieron en las entrevistas. No las parafrasees.
  • Las palabras que usó el cliente siempre son mejores que los términos de marketing.
  • Si no hay datos de entrevistas, continúa con los datos del proyecto (no obligatorio).

3. Contexto de tráfico

AskUserQuestion: "¿Dónde crees que la gente verá esta landing?"

  • A) Compartiendo enlaces en redes sociales (Threads, Twitter, Facebook)
  • B) A través de búsquedas (Google, Naver)
  • C) Publicaciones en comunidades (Discord, Kakao, Slack)
  • D) Anuncios (Meta, Google Ads)
  • E) Aún no lo sé

Ajuste del copy según el contexto de tráfico:

  • Redes sociales: el titular se convierte en el texto compartido → debe despertar curiosidad y ser específico.
  • Búsqueda: la palabra clave debe incluirse en el H1.
  • Comunidad: el orden es importante: empatizar con el problema → luego la solución.
  • Anuncios: el copy del anuncio y el mensaje de la landing deben coincidir (Message Match).

4. Redacción de titulares

Lee {REFS_DIR}/copywriting/copy-frameworks.md.

Salida:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Estrategia de la landing page
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

El objetivo de la landing es que alguien que ve tu producto por primera vez
sienta en 3 segundos "Esto es para mí".

Problema: {project.problem}
ICP: {project.icp}

Genera 3 titulares basados en el contexto:

Elige 3 categorías de entre las 15+ fórmulas de copy-frameworks.md que se ajusten al proyecto y genera un borrador de titular para cada una:

📝 Borradores de titulares (3)

A) [Enfocado en Resultado]
   "{ICP} logra {valor clave}"
   Justificación: {por qué se eligió esta fórmula}

B) [Enfocado en Problema]
   "Cansado de {problema}"
   Justificación: {insight de entrevista o basado en el estado}

C) [Enfocado en Especificidad]
   "{método/tiempo/público específico}"
   Justificación: {si hay datos reales, usa números; si no, solo especificidad sin números}

AskUserQuestion: "¿Qué dirección te parece mejor? (A/B/C) ¿O quieres modificar algo?"

5. Subtítulo + estructura de la página

Basado en el titular seleccionado, escribe el subtítulo:

Subtítulo: debilidad de la alternativa actual → en qué nos diferenciamos
Fórmula: "Antes {alternativa actual}. En cambio, {nuestra diferenciación}."

Guía de estructura de 11 secciones:

📋 Estructura de la landing (en este orden)

1. ▶ Hero — Titular + subtítulo + botón CTA
   → Debe verse sin hacer scroll. CTA obligatorio.

2. Barra de prueba social — solo lo que existe (nada falso)
   → Números, logotipos, recomendación de una línea. Si no hay, omitir la sección.

3. Problema — Describe específicamente el problema que sufre el ICP
   {si hay datos de entrevista}
   → "En las entrevistas apareció esta expresión: '{expresión real}'"
   {si no}
   → "¿Estás perdiendo tiempo en...?"

4. Cómo funciona — Máximo 3 pasos
   → Simplifica lo complejo. Cada paso en una frase.

5. Beneficios clave — 2-3 (no características, sino transformaciones)
   → No "puedes hacer X" sino "te conviertes en Y"
   → Antes: {dolor} → Después: {estado resuelto}

6. Testimonio — Cita real
   → Cita autorizada de un participante de la entrevista, usuario beta
   → Si no hay, omitir esta sección (prohibido inventar pruebas)

7. Casos de uso / Personas — "Perfecto para..."
   → 2-3 escenarios de uso específicos

8. Comparación — Diferencia frente a alternativas
   → Tabla o Antes/Después. Si hay análisis competitivo, úsalo.

9. Fragmento de caso de estudio — Resultado concreto
   → "En dos semanas, A recibió su primer pago"
   → Si no hay, omitir.

10. FAQ — Responde objeciones (3-5)
    → Las razones más comunes: "es caro", "no tengo tiempo", "ya uso otra cosa"

11. ▶ CTA final — Garantía + llamada a la acción
    → Mismo que el Hero CTA. Añade una frase que reduzca la ansiedad.

6. Diseño del CTA

🎯 Diseño del CTA

Fórmula: [Verbo de acción] + [Lo que obtienen] + [Calificador]

En tu caso:
  Objetivo: {recomendación según contexto de CTA}
  CTA recomendado: "{texto específico del CTA}"

Verificación de CTA fuerte/débil:

✅ CTA fuerte:
  "Empieza tu prueba gratuita" / "Únete al sprint de 30 días"
  "Empieza con {nombre del producto}" / "Recibe la guía"

❌ CTA débil (evitar):
  "Enviar" / "Registrarse" / "Más información" / "Empezar" / "Haz clic aquí"

7. Verificación de las Cuatro Fuerzas del JTBD

Consulta la sección JTBD Four Forces en {REFS_DIR}/copywriting/copy-frameworks.md.

🔄 Verificación psicológica de la conversión

Push (Insatisfacción actual):  ¿Tu copy toca esto? → {Sección Problema}
Pull (Nuevo atractivo):       ¿Tu copy muestra esto? → {Sección Beneficios}
Habit (Inercia):              ¿Tu copy rompe esto? → {Sección Comparación}
Anxiety (Ansiedad):           ¿Tu copy alivia esto? → {FAQ + Garantía}

{Si falta alguna fuerza}
⚠️ La fuerza {Fuerza} falta en tu copy. Debes abordarla en {sección correspondiente}.

8. Verificación anti-AI-slop

Lee {REFS_DIR}/copywriting/anti-ai-slop.md.

🚫 Lista de verificación para eliminar el olor a IA

Con solo evitar esto al escribir el copy, ya estás en el top 50%:

• Uso excesivo de guiones largos (—) → usa comas o puntos.
• "Innovador", "integral", "excepcional" → sustitúyelos por resultados concretos.
• "Lista de características" → muestra cómo la característica resuelve el problema.
• Jerga que el ICP no conoce → usa el lenguaje del cliente.
• Landing sin CTA → una página bonita de presentación ≠ landing.
• Enumerar de a tres → es un vicio de la IA. Usa dos o cuatro.

9. Guía de las Siete Revisiones (usar después de completar el copy)

📊 Verificación de calidad del copy (Siete Revisiones)

Una vez que hayas escrito todo el copy, revísalo con estas 7 dimensiones.
Ahora solo estamos definiendo la estructura; cuando escribas el copy,
ejecuta de nuevo /agnt:landing para que te ayude con las Siete Revisiones.

1. Claridad    — ¿Lo entiende un niño de primaria?
2. Voz         — ¿El tono es coherente? ¿Sin olor a IA?
3. Y qué       — ¿Cada frase responde al "¿y qué?"?
4. Pruébalo    — ¿Las afirmaciones tienen fundamento?
5. Especificidad — ¿En lugar de "muchos" usas números?
6. Emoción     — ¿Da la sensación de "esto habla de mí"?
7. Riesgo cero — ¿Eliminas las razones para no hacerlo?

Detalles: {REFS_DIR}/copywriting/seven-sweeps.md

Al re-ejecutar con el copy completo: Lee {REFS_DIR}/copywriting/seven-sweeps.md y aplica cada punto de revisión al copy, dando retroalimentación específica.

10. Benchmark

Lee {REFS_DIR}/benchmarks/conversion-benchmarks.md.

📊 Referencia de rendimiento — "¿Lo estoy haciendo bien?"

Visitas → recogida de email: 5-15% es normal (100 visitas, 5-15 recogidas)
Visitas → compra de pago: 1-3% es normal (100 visitas, 1-3 compras)

No evalúes la tasa de conversión con menos de 100 visitas.
Se necesitan al menos 200-300 datos para que sea significativo.

Tasa de conversión < 1% → Revisa la oferta o el titular
Tasa de conversión 1-3% → Normal (hay margen de optimización)
Tasa de conversión 3-5% → Bueno (aumenta el tráfico)
Tasa de conversión 5%+ → Excelente

11. Preparación para la ejecución/validación

AskUserQuestion: "¿Hasta dónde has llegado?"

  • A) Tengo un borrador/página que se puede publicar
  • B) Solo confirmé la estrategia de copy, aún no lo he creado
  • C) Solo tengo la estructura

Si elige A:

Bien. Ahora lo importante no es el despliegue, sino pulir el mensaje.
La URL pública la puedes añadir en `/agnt:channel` o `/agnt:launch-copy` cuando sea necesario.
Próximo paso: /agnt:channel — definir dónde mostrarlo

Si elige B:

Bien. Si ya tienes clara la dirección del copy, puedes empezar el borrador.
Puede ser en Notion, Carrd, codificando directamente, o modificando un sitio web existente — cualquier opción vale.

Próximos pasos:
- Para definir primero el canal de publicación, ve a `/agnt:channel`
- Si necesitas una revisión SEO/GEO, ve a `/agnt:seo-audit`

Si elige C:

No pasa nada. No tiene que ser perfecto.
La versión mínima es Hero → Problema → CTA, con esos tres es suficiente.

Después de refinar la estructura, puedes volver a `/agnt:landing` para revisar el copy.

En todos los casos (A/B/C) se guarda una nota estratégica en journey-brief.md (ver sección 11-bis).

11-bis. Escritura de journey-brief.md

Se ejecuta en todos los casos (A/B/C) (guardar nota estratégica):

Intenta leer {AGNT_DIR}/journey-brief.md.

Si el archivo no existe: crea uno nuevo usando la plantilla journey-brief de navigator-engine.md. Si el archivo existe: reemplaza las líneas - titulares:, - CTA:, - fuente de tráfico: dentro de la sección ## Market.

- titulares: {titular seleccionado}
- CTA: {CTA configurado}
- fuente de tráfico: {contexto de tráfico seleccionado}

12. Actualización del estado

Actualiza state.json:

  • meta.last_action = "landing"
  • meta.total_actions++

No se registran banderas de despliegue completado, registro de URL ni ejecuciones automáticas posteriores.

Reglas

  • agnt no crea ni despliega la landing en tu lugar — el ICP lo hace por sí mismo.
  • Las guías son breves y directas — instrucciones prácticas, no teoría de marketing.
  • Si hay SPEC, úsalo; si no, continúa basándote en el estado (no obligatorio).
  • Si hay datos de entrevistas, utiliza el lenguaje del cliente directamente en el copy.
  • Los titulares deben presentar obligatoriamente 3 alternativas y explicar su justificación.
  • Las Siete Revisiones se aplican después de completar el borrador del copy.
  • Aplica las reglas anti-AI-slop — un copy con olor a IA reduce la tasa de conversión.
  • Prohibido inventar pruebas: si no hay testimonios, números o casos de estudio, omite la sección correspondiente.
  • Los benchmarks tienen como objetivo indicar el "rango normal" — no son criterios absolutos.
  • Este skill solo guarda notas de estrategia/copy, no registra el estado de despliegue ni ejecuciones automáticas posteriores.
  • Tono: informal, en español latinoamericano.

Skills relacionados