~/codigoagente
Agentes de IA

Psicología del marketing con un agente: la skill que le enseña a tu IA cómo piensa tu comprador

Al final del artículo tienes el comando, el prompt listo para copiar y un .md para descargar.

marketing-psychology es una skill gratuita de la colección coreyhaines31/marketingskills (MIT) que carga en tu agente 50+ modelos mentales de psicología del marketing: reciprocidad, peak-end, aversión a la pérdida, anclaje, prueba social, paradoja de la elección, framing, zero-price effect. No es un prompt mágico: es una referencia estructurada que Claude Code, Codex, Cursor y cualquier agente compatible con skills pueden consultar cuando tú le pides "mira esta landing" o "diseña el bloque de precios". Y cuando la combinas con las otras skills del mismo repo (cro, copywriting, copy-editing, content-strategy) tu agente deja de escribir texto genérico y empieza a mover una métrica concreta.

En esta guía de tres partes verás cómo usar la skill de verdad en un proyecto, con ejemplos tomados de este mismo blog. En esta primera parte: qué es, cómo instalarla y los ocho modelos de la skill que explican cómo decide tu comprador. En la parte 2 cubrimos persuasión y copy y en la parte 3 precios y arquitectura de decisión.

Tres frentes de la skill: pensar bien el problema, entender al comprador y persuadir sin engañar · codigoagente

Qué es marketing-psychology y de dónde sale

  • Repositorio: github.com/coreyhaines31/marketingskills, publicado por Corey Haines (fundador de Everyone Hates Marketers y ex-growth de Baremetrics).
  • Licencia: MIT. La usas gratis en proyectos cerrados sin pagar nada y sin atribución obligatoria en producto, aunque es de buena educación mantener el aviso del LICENSE.
  • Versión analizada: 2.0.3. El SKILL.md ocupa ~12 KB y agrupa modelos en seis bloques: pensamiento, comprador, persuasión, precios, diseño y crecimiento.
  • Qué agentes la entienden: Claude Code (nativo), Codex CLI, Cursor, OpenCode, Gemini CLI y cualquiera que soporte el formato de Agent Skills. Las instalaciones totales de la colección rondan las 228.000, tal como vimos en el post sobre find-skills.

La skill no genera texto por sí sola. Lo que hace es estructurar el razonamiento del agente: cuando le pides una decisión de marketing (un titular, un bloque de precios, un correo), consulta la tabla "Quick Reference" del SKILL.md, identifica los dos o tres modelos que aplican y los aplica en vez de repetir frases de curso de LinkedIn.

Instalar la skill en 30 segundos

Desde Claude Code, con el plugin de skills ya activo:

terminalsh
npx skills add coreyhaines31/marketingskills@marketing-psychology

Si quieres toda la colección de golpe (pensada así por su autor, porque las skills se complementan), instala solo la raíz y Claude las carga al vuelo cuando hacen falta:

terminalsh
npx skills add coreyhaines31/marketingskills

Para el proyecto codigoagente la tenemos instalada junto con cro, copywriting y copy-editing. Y el archivo .claude/product-marketing.md del repositorio sirve de contexto: la primera instrucción del SKILL.md es precisamente leer ese fichero antes de aplicar ningún modelo, así tu agente conoce tu producto, tu lector y tu voz antes de persuadir.

El bloque de modelos que de verdad mueve ventas

El SKILL.md lista 50+ modelos. Si solo pudieras aprender ocho hoy para explicárselos a tu agente, estos son los que aparecen una y otra vez en las decisiones del blog.

1. Reciprocidad: da antes de pedir

Las personas devuelven favores. Si tu agente escribe un artículo que resuelve el problema del lector (con comandos probados, errores reales y la licencia bien explicada), ese lector se siente en deuda cuando ve el bloque del patrocinador o la invitación a compartir.

Ejemplo real: en este blog el patrocinador de Safe Build Labs aparece como una franja discreta hacia la mitad del artículo, nunca al principio. Antes de llegar ahí el lector ya ha visto comandos que funcionan, versiones exactas y el porqué de cada decisión. Ese orden está pensado para que llegue al bloque habiendo recibido algo útil antes: la reciprocidad funciona cuando has dado primero, no cuando pides al entrar.

2. Peak-end rule: recuerdan el pico y el final

Daniel Kahneman demostró que recordamos una experiencia por su momento más intenso y por su final, no por el promedio. Un post con una conclusión débil se olvida aunque el medio sea brillante.

Ejemplo real: el bloque "Úsalo directamente" (recurso con el prompt listo para pegar) se añadió al final de los posts accionables en el PR #92 de este repositorio. El pico es el prompt que puedes copiar y usar en 30 segundos; el final es "Nos ayuda a crecer", donde invitamos a compartir. Si tu agente te está escribiendo un artículo, pídele que diseñe primero el pico y el final, después el medio.

3. Aversión a la pérdida: perder duele el doble

La prospect theory dice que perder 100 duele más que ganar 100 alegra. Por eso los titulares en negativo ("no instales esta skill sin leer esto") ganan a los positivos cuando el riesgo es real.

Ejemplo real: cuando analizamos la skill SkillSpector titulamos "Escanea las skills antes de instalarlas: una filtró credenciales". El titular no promete una mejora abstracta: señala la pérdida concreta (credenciales filtradas), que es exactamente lo que la prospect theory predice que capta la atención del lector técnico.

4. Zero-price effect: "gratis" no es un precio bajo

El salto de 1 USD a 0 USD es psicológicamente mayor que el de 2 USD a 1 USD. Por eso un tier gratis tiene un tirón desproporcionado.

Ejemplo real: el ebook "Claude Code de cero a producción" se vende en Hotmart a 19,99 USD. En el blog ofrecemos antes el prompt gratuito del bloque "Úsalo directamente": el lector lo copia, lo prueba y entonces el ebook pasa de ser un gasto a ser el siguiente paso natural. Lo gratuito no es solo "más barato": entra en una categoría mental distinta, que es justo lo que explica el zero-price effect de Dan Ariely.

5. Prueba social: los números convencen

Las personas copian lo que otras hacen. Si un repositorio tiene 12.000 estrellas y 2.100 forks, tu lector asume que no es basura y baja la guardia técnica.

Ejemplo real: cada tarjeta de repositorio al final de un post muestra la licencia y el enlace a GitHub. En el post de find-skills listamos el contador de instalaciones de cada skill ("228.000 instalaciones" junto a marketingskills@seo-audit) en vez de calificarla como "la más popular". Dato social concreto, verificable en el plugin.json del repo, no adjetivo.

6. Paradoja de la elección: menos opciones, más decisiones

Siete planes de precios paralizan. Tres mueven el tráfico. Sheena Iyengar lo midió en el famoso experimento de las mermeladas: 24 variedades convirtieron al 3 %; 6 variedades convirtieron al 30 %.

Ejemplo real: en la página del kit decidimos mostrar un único producto recomendado con los demás como "también disponibles" en una lista pequeña, en lugar de tres tarjetas en paralelo. La página pide una decisión, no tres.

7. Anclaje: la primera cifra manda

La primera cifra que ve el lector condiciona todas las que vienen después. Si abres con "los agentes cuestan 500 USD al mes", 19 USD parece una ganga.

Ejemplo real: en el post de slopus anclamos el coste de un modelo propio con "entrenar un LLM desde cero cuesta entre 500 mil y 10 millones de dólares". El coste del plan Max de Claude (200 USD/mes) pasa de "caro" a "regalado". Lo veremos a fondo en la parte 3.

8. Default effect: lo preseleccionado gana

Las opciones por defecto se aceptan el 70-80 % de las veces. Lo demuestra el estudio de donación de órganos en Europa: países con opt-out tienen 90 % de donantes, países con opt-in tienen 15 %. Misma gente, distinto default.

Ejemplo real: en el bloque "Úsalo directamente" la primera pestaña es "Proyecto nuevo" con el prompt más seguro para alguien que empieza. La segunda, "Proyecto avanzado", es más agresiva. El lector pulsa casi siempre la primera, que es exactamente la ruta recomendada.

Cómo decirle a tu agente que use estos modelos

El truco no es listar los ocho modelos en cada prompt. Es cargar la skill, dejarle leer el .claude/product-marketing.md y hacerle una pregunta de marketing concreta. Por ejemplo:

snippettext
Lee marketing-psychology. Tenemos un post sobre la skill X. Al final queremos que
el lector compre el ebook (19,99 USD). Dime los tres modelos mentales que mejor
encajan para esta petición y una frase de ejemplo para cada uno.

Tu agente devolverá algo como:

  • Reciprocidad: "ya te he dado el prompt completo gratis; si esto te ahorró una tarde, el ebook te ahorra una semana".
  • Peak-end: colocar el enlace al ebook justo después del recurso.es.md, no al principio.
  • Zero-price effect: destacar primero el prompt gratuito, después el precio del ebook.

En la parte 2 de la guía veremos cómo pasar de modelos a copy que no suena a vendedor de barrio: autoridad, compromiso, escasez real y framing. En la parte 3 veremos precios, decoys y cómo diseñar una página de elección que de verdad decida.

Preguntas frecuentes

¿Sirve la skill si no vendo nada? Sí. Aplicar peak-end a un README, reciprocidad a una landing de proyecto open source o aversión a la pérdida a un aviso de seguridad mejora el resultado tanto como cuando vendes un producto.

¿Cuánto cuesta? 0 USD. El SKILL.md es una referencia estática que vive en tu máquina, no llama a ningún servicio. El coste es el de los tokens que tu agente consume al leerla (son unos 3.000-4.000 tokens de entrada; con Caveman activo, menos).

¿Es ético? Depende de ti. La skill avisa de que "ethical application" es responsabilidad tuya: usar escasez cuando es falsa o decoys para engañar al comprador funciona a corto plazo y te quema a largo. En la parte 2 insistimos en esto.

¿Vale para redes sociales? Vale para cualquier decisión de contenido. En el blog usamos la misma skill para el guion de los Shorts por post, no solo para los artículos.

Qué sigue

Pasa a la parte 2: persuasión y copy ético con marketing-psychology y aprende a convertir modelos mentales en párrafos que convencen. Después, la parte 3: precios y arquitectura de decisión te enseña a diseñar la página donde el lector por fin paga.

// recurso · úsalo directamente

marketing-psychology lista para usar en tu agente

Instala la skill, carga el contexto de tu producto y pégale el prompt a tu agente. Funciona con Claude Code (plan Pro o Max), Codex, Cursor y cualquier runner compatible con Agent Skills.

Licencia del repositorio: MIT

1. Instala

Solo marketing-psychology
npx skills add coreyhaines31/marketingskills@marketing-psychology
Toda la colección (cro, copywriting, copy-editing, content-strategy, marketing-psychology)
npx skills add coreyhaines31/marketingskills

2. Elige tu caso

Pega este prompt en tu agente
Carga la skill marketing-psychology. Vamos a usarla en este proyecto.

1. Crea un archivo .claude/product-marketing.md con: qué vende el producto, para quién, cuál es el objetivo medible (altas, ventas, clics) y la voz de marca en 3 líneas.
2. Léelo antes de aplicar ningún modelo.
3. Cuando yo te dé una decisión de marketing (un titular, un bloque de precios, un correo, un post), responde con:
   - Los 2 o 3 modelos de la skill que mejor encajan.
   - Una frase de ejemplo aplicando cada modelo.
   - Qué métrica deberíamos mover y cómo medirla.
4. Si una decisión es manipuladora (escasez falsa, decoy engañoso, prueba social inventada), negocia o niégate y propón una alternativa ética.
5. No cites el nombre del modelo en el texto final que verá el lector: aplícalo, no lo expliques.

3. Guía de uso

  1. Abre tu proyecto y pega el prompt como primer mensaje.
  2. Revisa el .claude/product-marketing.md que crea: ese fichero es la fuente de verdad de todas las decisiones siguientes.
  3. Pídele una decisión concreta ("rediseña el final de este post", "elige el titular de este correo entre tres").
  4. Cuando tengas una variante, mídela con tu analítica (Umami, Plausible, GA4) durante 7-14 días antes de declarar ganadora.
Prompt y guía corta en un archivoRepositoriocoreyhaines31/marketingskills

Nos ayuda a crecer

codigoagente es gratis y sin muros de pago. Si este artículo te sirvió, cualquiera de estas cosas mantiene el blog en marcha.

// newsletter

Un correo a la semana con los repos que valen la pena

Los artículos nuevos de la semana, probados con código real. Sin spam; te das de baja con un clic.

Agentes de IA

guía · Guía completa de ECC para Claude Code · #8

AgentShield, el escáner de ECC, revisa CLAUDE.md, settings.json, MCP, hooks y agentes. Lo probamos con una configuración vulnerable y con el propio ECC.
  • Seguridad y revisión de código
  • Claude Code
leer artículo
Agentes de IA

guía · Guía completa de ECC para Claude Code · #7

Medimos cuánto contexto ocupa ECC con /ecc:context-budget --audit (unos 12.500 tokens en el perfil minimal) y cómo recortarlo: modelo, compactación y MCP.
  • Claude Code
  • Skills para tus agentes
leer artículo
Agentes de IA

guía · Guía completa de ECC para Claude Code · #6

Qué hacen los 28 hooks de ECC, cómo GateGuard frena la primera edición, cómo guardar y retomar sesiones y cómo funcionan los instincts del aprendizaje continuo.
  • Claude Code
  • Skills para tus agentes
leer artículo