🌱 Empieza aquí · Auditor de imágenes para SEO
¿Alguna vez compartiste un enlace de tu sitio en WhatsApp, LinkedIn o Facebook y salió sin foto, o con una imagen fea y cortada? Eso pasa cuando las imágenes de vista previa de tu sitio (las que Google y las redes muestran) están mal puestas o faltan. Además, unas imágenes pesadas o sin descripción le restan puntos a tu posicionamiento en buscadores.
Esta semilla te instala un auditor que revisa todo eso por ti: recorre tu sitio, te dice qué páginas tienen la imagen de vista previa bien, cuáles no, cuáles pesan de más o les falta descripción, y te arma un plan priorizado de qué imágenes generar primero, con una idea de qué debería mostrar cada una. Eso sí: no genera imágenes solo (para no gastarte dinero sin permiso); solo te deja la lista lista para que tú, o tu herramienta de imágenes de siempre, las produzca.
Para ti (el humano)
Solo tienes que decir una frase. Abre esta carpeta con tu asistente (Claude Code o Cowork) y escríbele:
"Siembra esta semilla 🌱"
¿Otras formas de pedirlo? "instala esta semilla", "activa el auditor de imágenes SEO", "haz el setup de esto". Te entiende igual. De ahí en adelante tu asistente hace toda la parte técnica; tú no tocas nada. Vas a ver algunas palabras en inglés en la pantalla; ni caso, él te guía.
Cuando quieras usarlo, solo dile algo como "audita las imágenes de mi sitio para SEO" y apúntale a la carpeta de tu sitio o pásale las páginas. Te devuelve el diagnóstico y el plan. Tú decides qué generar.
Para el asistente que siembra 🤖
Eres el asistente que va a instalar esta semilla. Es un agente (un subagente al que se
le delega la misión de auditar imágenes para SEO). No es un hook (una automatización
que se dispara sola ante eventos): no hay que registrar nada en settings.json ni dar
permisos de ejecución (chmod) — es un archivo de definición en texto, no un script. Sigue
estos pasos tal cual.
El placeholder entre <...> lo resuelves tú según la plataforma:
<TU-RUTA-DE-AGENTES>→ la carpeta donde viven las definiciones de agentes del asistente.- Claude Code (usuario):
~/.claude/agents/(recomendado; el agente queda disponible en todas las sesiones). - Por proyecto:
.claude/agents/dentro del proyecto (si la persona solo lo quiere ahí). - Cowork: la carpeta de configuración equivalente (
~/.claude/agents/si comparte el mismo directorio de config).
- Claude Code (usuario):
Paso 1 · Copiar la definición del agente
El kernel trae un solo archivo:
kernel/seo-image-gen.md— la definición del agente (el auditor en sí).
Cópialo a <TU-RUTA-DE-AGENTES>. Crea la carpeta si no existe.
mkdir -p <TU-RUTA-DE-AGENTES>
cp kernel/seo-image-gen.md <TU-RUTA-DE-AGENTES>/seo-image-gen.md
Nota: este agente audita y planea, nunca genera imágenes (control de costo). La generación real se delega a la herramienta o skill de imágenes que la persona ya use. No necesita ninguna llave de API ni credencial para hacer su trabajo de análisis. Si en el paso 3 le mencionas una carpeta de aprendizajes que no existe, ignórala: es opcional.
Paso 2 · Confirmar qué va a auditar
Este agente trabaja sobre archivos: el repositorio del sitio, el HTML renderizado o una lista de páginas. Pregúntale a la persona en lenguaje simple: "¿Dónde vive tu sitio —una carpeta de código, un HTML exportado, o me das las URLs?". No necesita configuración previa; solo saber a qué apuntar cuando lo invoques.
Paso 3 · VERIFICACIÓN post-siembra (obligatoria)
Primero confirma que el archivo quedó en su lugar y que su encabezado se lee bien:
ls -la <TU-RUTA-DE-AGENTES>/seo-image-gen.md && head -8 <TU-RUTA-DE-AGENTES>/seo-image-gen.md
Salida esperada — el archivo existe y su encabezado empieza con:
---
name: seo-image-gen
description: Auditor de imágenes para SEO...
tools: Read, Bash, Glob, Grep
model: sonnet
Luego haz una prueba funcional real. Desde tu propia conversación, delégale una auditoría chica sobre una carpeta o página de la persona:
Usa el agente
seo-image-genpara auditar las imágenes de [una página o carpeta del sitio de la persona].
Qué esperar: que te devuelva una tabla de resumen (páginas con imagen OG, tamaños,
schema, formatos, peso) y un plan de generación priorizado por página, marcando la
fuente como "Auditoría de imágenes (análisis estático)". Lo que no debe pasar es que
intente generar imágenes por su cuenta: si lo hace, no se instaló la versión correcta;
confirma que copiaste kernel/seo-image-gen.md a <TU-RUTA-DE-AGENTES> y que su encabezado
del Paso 3 se lee completo.
Cuando las dos verificaciones den lo esperado, la siembra está completa. Reporta a la persona en una línea, sin tecnicismos.
¿Cómo sé que funcionó? (para el humano)
Fácil: pídele a tu asistente que "audite las imágenes de tu sitio con el seo-image-gen" y apúntale a tu web. En un rato te devuelve un diagnóstico claro —qué páginas están bien de imagen y cuáles no— y una lista priorizada de qué imágenes crear primero, con una idea de qué debería mostrar cada una. Si lees eso y sabes exactamente por dónde empezar sin haber gastado un peso en generar nada todavía, ya quedó. A partir de ahí tienes un auditor de imágenes de cabecera que te dice dónde estás perdiendo puntos de SEO y visibilidad. 🌱