jameellzx/katib

Katib — habilidad de copywriting para sitios web

Adaptado del "AI Market Research Sprint" (escrito para un chat de ChatGPT) a un flujo de trabajo de agente. Regla central para cada paso: argumento primero, palabras al final — lee references/argument-first.md antes del Paso 1.

Orden fijo (nunca saltar, nunca reordenar)

0 Captación → 1 Revisión de referencia → 2 Investigación → 3 Avatar → 4 Brief de oferta → 5 Creencias → 6 Copy web → 7 Verificación final

Rutas

• Archivos del skill: relativos al directorio base de este skill (se muestra cuando se carga el skill). La herramienta de Reddit es tools/reddit_fetch.py allí — entrega a los investigadores su ruta absoluta.
• Carpeta del cliente: <raíz del proyecto actual>/katib-clientes/<slug-del-cliente>/ con: 00-input.md · 01-reference-review.md · 02-research.md · research-raw/ · 03-avatar.md · 04-offer-brief.md · 05-beliefs.md · 06-website-copy.md

Cada paso lee los archivos anteriores. Si la carpeta ya existe, léela y reanuda desde el primer archivo faltante (o rehacer solo el paso que el usuario nombre).

Pasos

Configuración (primera ejecución, y cuando falle) — verifica PinchTab: pinchtab --version y pinchtab health. Si falta o no ha iniciado sesión → guía al usuario a través de references/setup-pinchtab.md paso a paso antes de la investigación. Si ya funciona → no digas nada, continúa.

0. Captación — pregunta lo que falte, en un solo mensaje: producto (qué es, precio si se conoce), audiencia, mercado/país, idioma de salida (árabe del Golfo / árabe MSA / inglés / ambos), captura de pantalla (o URL) de la página de referencia, cualquier cosa que la marca ya tenga (reseñas, pruebas, garantía, historia). Escribe 00-input.md.

1. Revisión de referencia — sigue references/sales-page-review.md. Escribe 01-reference-review.md. ⏸ Pausa: muestra el veredicto + mapa de secciones + qué tomar prestado. Espera la confirmación.

2. Investigación — sigue references/research-method.md y references/research-agents.md. Lanza los 5 investigadores en paralelo (R1–R4 + R5 Reddit), fusiona en templates/research-doc.md → 02-research.md. Instagram, TikTok y Reddit con sesión iniciada se leen a través del perfil de investigación de PinchTab (solo lectura); fallback: el Chrome con sesión del usuario (pestaña propia), luego Scrapling. Si el mercado local es reducido, R1 y R5 amplían al mismo tipo de negocio a nivel mundial y etiquetan esas citas con el país. Luego escribe 02-research-summary.md para el usuario: en el idioma del usuario, secciones cortas con encabezados emoji (quién / sueños / dolor / culpa / creencias / mejor historia / competidores / candidatos a mecanismo / advertencias / vacíos), 1–3 citas clave cada una con [S#]. ⏸ Pausa: muestra el bloque de resumen y las secciones flojas. Espera la confirmación (el usuario puede pedir más investigación).

3. Avatar — llena templates/avatar.md solo desde 02-research.md → 03-avatar.md. Comprador de negocio → "Ingresos mensuales"; consumidor → "Ingresos / poder adquisitivo". Sin pausa; muéstralo con el Paso 4. Más de un segmento → un archivo de avatar por segmento (03-avatar-<segmento>.md); el usuario indica cuál lidera el copy.

Opciones de posicionamiento (opcional, cuando el usuario lo pida) — ejecuta el skill creator-toolkit:personal-brand-expert en la marca (funciona también para negocios), usando 02-research.md y los avatares. Escribe 03b-positioning.md con varias opciones; la elección del usuario alimenta la gran idea en el Paso 4.

4. Brief de oferta — sigue references/offer-brief-guide.md, llena templates/offer-brief.md en orden → 04-offer-brief.md. ⏸ Pausa después del campo 6: 3 opciones cada una para UMP, UMS, gran idea. El usuario elige. Luego completa los campos 7–20.

5. Creencias — sigue references/beliefs.md → 05-beliefs.md. ⏸ Pausa: el usuario aprueba las creencias antes de cualquier copy.

6. Copy web — sigue references/website-copy.md, llena templates/website-copy.md → 06-website-copy.md.

7. Verificación final — ejecuta el Pase 4 de references/website-copy.md, luego muestra el copy, la lista "necesita prueba de la marca" y preguntas abiertas. ⏸ El usuario aprueba o pide cambios.

Reglas estrictas

• Nunca inventes citas, reseñas, números, estudios, personas, precios o garantías. Si falta → pregunta o señala.
• Cada cita de investigación es textual con una URL que fue abierta. Las citas del avatar citan [S#] del documento de investigación.
• Nunca copies frases de la página de referencia; solo toma prestada la estructura.
• Escribe el copy en el idioma que pidió el usuario. Palabras claras, frases cortas.
• Señala las afirmaciones de salud, financieras y legales para cumplimiento normativo.
• Habla al usuario en su idioma (generalmente árabe del Golfo), corto y simple. Los archivos del skill se mantienen en inglés.

Más adelante: anuncios

Aún no está construido. Cuando te lo pidan, reutiliza 04-offer-brief.md y 05-beliefs.md (una creencia o la gran idea por anuncio). Sin nueva investigación.