🌱 Empieza aquí · Optimización de imágenes para SEO

¿Tu sitio carga lento por las fotos, o tus imágenes no aparecen en Google Imágenes y no sabes por qué? Esta semilla le enseña a tu asistente a auditar las imágenes de una página —el alt text (el texto que describe cada imagen), el peso de los archivos, el formato, las dimensiones y la carga— y a entregarte una lista clara de qué arreglar primero, ordenada por el impacto que tiene. Y, si quieres, hasta te optimiza los archivos: los convierte a formatos modernos y les inyecta la metadata que Google muestra en los resultados.

Para instalarla

Abre esta carpeta con Claude Code o Cowork y dile a tu asistente:

"Siembra esta semilla 🌱"

Con eso basta de tu parte. Tu asistente hace toda la parte técnica y al final te dice cómo comprobar que quedó funcionando. Vas a ver algunas palabras en inglés en la pantalla; ni caso, él te guía.

¿Otras formas de pedírselo? "instala esta semilla", "pon a funcionar el auditor de imágenes", "haz el setup de esto". Te entiende igual.

Un detalle (opcional): la parte que optimiza archivos de imagen (convertir a WebP y ponerles metadata) usa unas herramientas de línea de comandos gratuitas (exiftool, cwebp, ImageMagick, FFmpeg). No las necesitas para la auditoría en página; el skill revisa lo que se pueda con lo que haya y te dice qué falta. Si tu asistente ve que no están, te dice cómo instalarlas.

Para el asistente que siembra 🤖

Eres el asistente que va a instalar esta semilla. Es un skill (una habilidad que se activa por palabras clave o a petición del usuario). No es un hook (gancho de automatización que se dispara solo): no hay que registrar nada en settings.json ni dar permisos de ejecución (chmod) — es un archivo de definición en texto que tu plataforma descubre solo. Sigue estos pasos.

El placeholder <TU-RUTA-DE-SKILLS> lo resuelves según la plataforma:

• Claude Code (usuario): $HOME/.claude/skills/seo-images/ (recomendado; queda disponible en todas las sesiones).
• Por proyecto: .claude/skills/seo-images/ dentro del proyecto (si solo lo quiere ahí).
• Cowork: la carpeta de habilidades equivalente ($HOME/.claude/skills/seo-images/ si comparte el mismo directorio de configuración).

Paso 1 · Copiar la habilidad y su licencia

Los skills se descubren por carpeta: cada uno vive en su propia subcarpeta con el SKILL.md dentro. Copia el SKILL.md y la licencia MIT que lo acompaña.

macOS / Linux (o Windows con Git Bash):

mkdir -p "$HOME/.claude/skills/seo-images"
cp kernel/SKILL.md "$HOME/.claude/skills/seo-images/SKILL.md"
cp kernel/LICENSE.txt "$HOME/.claude/skills/seo-images/LICENSE.txt"

Windows (PowerShell):

$dest = "$HOME\.claude\skills\seo-images"
New-Item -ItemType Directory -Force -Path $dest | Out-Null
Copy-Item kernel\SKILL.md  "$dest\SKILL.md"
Copy-Item kernel\LICENSE.txt "$dest\LICENSE.txt"

La LICENSE.txt es la licencia MIT del método original: viaja siempre junto al SKILL.md, no la borres.

Paso 2 · Herramientas de optimización de archivos (opcional)

La auditoría en página no necesita nada extra. La parte de optimizar archivos (convertir a WebP/AVIF e inyectar metadata) sí usa herramientas de línea de comandos. Si el usuario va a usar esa parte, revisa qué tiene:

which exiftool cwebp convert ffmpeg

Si falta alguna, recomiéndala en simple (todas son gratuitas): exiftool (sudo apt install libimage-exiftool-perl), cwebp (sudo apt install webp), ImageMagick y FFmpeg suelen venir preinstalados o se instalan igual con el gestor de paquetes del sistema. No son obligatorias: si no están, el skill usa la alternativa que sí exista y lo dice.

Paso 3 · VERIFICACIÓN post-siembra (obligatoria)

a) El archivo quedó colocado. Confirma que el SKILL.md existe y que su encabezado se lee bien:

ls -la "$HOME/.claude/skills/seo-images/SKILL.md" && head -3 "$HOME/.claude/skills/seo-images/SKILL.md"; echo "exit=$?"

Salida esperada — el archivo aparece listado y su encabezado arranca con la definición del skill (name: seo-images y su description), con exit=0. Si sale No such file or directory, la copia no se hizo; repite el Paso 1.

b) La habilidad se activa (prueba de comportamiento). En una conversación nueva, pídele al asistente algo que dispare el skill, por ejemplo: "audita las imágenes de example.com" o "revísame el alt text y el peso de las imágenes de esta página". La conducta correcta es que el asistente entregue las secciones de la auditoría —resumen con conteo de imágenes sin alt text, sobredimensionadas y sin dimensiones, más una lista priorizada por ahorro de peso— y que, si alguna imagen está detrás de un CDN o autenticación y no pudo medir su peso, lo diga en lugar de inventar el tamaño. Si en vez de eso suelta una auditoría genérica sin abrir la página, el skill no se cargó: revisa que el SKILL.md esté en <TU-RUTA-DE-SKILLS> y que su encabezado del Paso 3a se lea completo.

Cuando ambas partes pasen, avísale al humano en una línea qué gana con esto.

✅ ¿Cómo sé que funcionó?

Fácil: pídele a tu asistente que "audite las imágenes" de tu sitio y dale tu dirección web. En un rato te devuelve un tablero claro: cuántas imágenes tienes, cuáles no traen texto alternativo, cuáles pesan de más, cuáles están en un formato viejo y cuáles no tienen dimensiones (esas son las que hacen que la página "salte" al cargar). Y te lo ordena por lo que más ahorra si lo arreglas primero. Si además le pides que te optimice una carpeta de fotos, te las convierte a WebP y les pone la metadata que Google muestra en los resultados. Si ves ese tablero con su lista de pendientes priorizada, ya quedó. 🌱