🌱 Empieza aquí · Auditoría técnica de SEO

¿Tu sitio web se ve bien pero no aparece en Google como debería? Muchas veces el problema no es el contenido, sino la parte técnica: cosas que no ves pero que los buscadores sí, como si tu sitio se puede rastrear, si carga rápido, si es seguro o si funciona bien en el celular. Esta semilla le enseña a tu asistente a hacer una auditoría técnica de SEO de un sitio en 9 categorías y a entregarte un reporte con un puntaje por categoría y una lista de qué arreglar primero.

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 técnico de SEO", "haz el setup de esto". Te entiende igual.

Lo único que puedes conseguir tú (opcional) son credenciales gratuitas de las APIs de Google (PageSpeed Insights / CrUX). No las necesitas para arrancar: sin ellas, tu asistente igual audita el sitio y estima las métricas con datos de laboratorio. Con ellas, suma datos de usuarios reales.

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-technical/ (recomendado; queda disponible en todas las sesiones).
• Por proyecto: .claude/skills/seo-technical/ dentro del proyecto (si solo lo quiere ahí).
• Cowork: la carpeta de habilidades equivalente ($HOME/.claude/skills/seo-technical/ 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-technical"
cp kernel/SKILL.md "$HOME/.claude/skills/seo-technical/SKILL.md"
cp kernel/LICENSE.txt "$HOME/.claude/skills/seo-technical/LICENSE.txt"

Windows (PowerShell):

$dest = "$HOME\.claude\skills\seo-technical"
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 · Credenciales de Google (una conversación con el humano, opcional)

Este skill no trae credenciales; usa las que el humano configure. No son obligatorias para arrancar. Pregúntale, en simple:

1. "¿Quieres configurar la API de PageSpeed Insights de Google?" — suma datos de Core Web Vitals de usuarios reales (CrUX), que reemplazan las estimaciones de laboratorio.

Si el humano no quiere configurar nada, está perfecto: el skill arranca sin credenciales y estima las métricas con datos de laboratorio, marcando el límite con honestidad. Guarda cualquier credencial en una variable de entorno o en el gestor de la plataforma, nunca dentro del archivo del skill ni en un sitio que se comparta.

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-technical/SKILL.md" && head -3 "$HOME/.claude/skills/seo-technical/SKILL.md"; echo "exit=$?"

Salida esperada — el archivo aparece listado y su encabezado arranca con la definición del skill (name: seo-technical 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: "hazme una auditoría técnica de SEO de example.com". La conducta correcta es que el asistente recorra las 9 categorías (rastreabilidad, indexabilidad, seguridad, estructura de URL, móvil, Core Web Vitals, datos estructurados, renderizado JS e IndexNow) y devuelva el puntaje técnico sobre 100, el desglose por categoría con su semáforo (pasa / alerta / falla) y la lista de problemas ordenada por prioridad (críticos, alta, media, baja). Si en vez de eso suelta un consejo genérico sin estructura ni puntaje, 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 haga "una auditoría técnica de SEO" de tu sitio y dale tu dirección web. En un rato te devuelve un reporte claro: un puntaje sobre 100, cada una de las 9 categorías con su semáforo (pasa, alerta o falla) y una lista de qué arreglar primero, separada por urgencia. Si ves ese reporte con su puntaje y sus prioridades, ya quedó. 🌱