🌱 Empieza aquí · Analista de rendimiento web (Core Web Vitals)
¿Sientes que tu página carga lento pero no sabes exactamente qué la frena? Esta semilla te instala un analista de rendimiento que audita tu sitio con las mismas métricas que usa Google (las Core Web Vitals: qué tan rápido aparece el contenido, qué tan rápido responde y qué tan estable se ve mientras carga), encuentra los cuellos de botella y te entrega una lista de arreglos ordenada por impacto. Del "está lento" al "arregla esto primero".
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 analista de rendimiento", "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.
Un extra opcional (recomendado): consigue una API key gratuita de PageSpeed Insights (es gratis, solo necesitas una cuenta de Google). Con ella, el analista mide usuarios reales en vez de solo revisar el código. Si no la tienes, funciona igual; solo trabaja con lo que ve en el HTML.
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 el rendimiento de una página). 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.
Los placeholders entre <...> los resuelves tú según la plataforma:
<TU-RUTA-DE-AGENTES>→ 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 el humano 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-performance.md (la definición del agente). Cópialo a
<TU-RUTA-DE-AGENTES>. Crea la carpeta si no existe.
macOS / Linux / Windows con Git Bash:
mkdir -p <TU-RUTA-DE-AGENTES>
cp kernel/seo-performance.md <TU-RUTA-DE-AGENTES>/seo-performance.md
Windows con PowerShell (si no usas Git Bash):
New-Item -ItemType Directory -Force -Path <TU-RUTA-DE-AGENTES>
Copy-Item kernel\seo-performance.md <TU-RUTA-DE-AGENTES>\seo-performance.md
Nota sobre la ruta de aprendizajes. El agente guarda lo que aprende en
~/.claude/agents/learnings/(sección Mejora continua, al final deseo-performance.md). Esa ruta está escrita para una siembra de usuario en~/.claude/. Si sembraste en otro lado (por proyecto, o un Cowork con un directorio de config distinto), abre el archivo copiado y alinea esas dos rutas para que apunten a la carpeta de config real; de lo contrario el agente no encontrará ni podrá guardar sus aprendizajes. Es opcional: el agente funciona igual sin esa carpeta.
Paso 2 · (Opcional) Configurar la API key de PageSpeed Insights
Si el humano tiene o consigue una API key gratuita de PageSpeed Insights, el análisis mejora mucho (datos de campo reales en vez de solo inspección de HTML). Pregúntale si la tiene. La forma limpia de guardarla es en una variable de entorno, para no escribirla dentro de ningún archivo:
# macOS / Linux / Windows con Git Bash (agrégalo a tu ~/.zshrc o ~/.bashrc para que persista):
export PAGESPEED_API_KEY="la-clave-del-humano"
# Windows con PowerShell (queda persistente para tu usuario; ábrelo en una ventana nueva):
setx PAGESPEED_API_KEY "la-clave-del-humano"
Cuando el agente vaya a llamar a la API, usa esa variable en el comando curl en lugar de escribir la
clave a mano. Si el humano no tiene key, no bloquees la siembra: el agente ya está preparado para
trabajar analizando el HTML sin ella.
Paso 3 · VERIFICACIÓN post-siembra (obligatoria)
Primero confirma que el archivo quedó en su lugar y que su encabezado se lee bien:
# macOS / Linux / Windows con Git Bash:
ls -la <TU-RUTA-DE-AGENTES>/seo-performance.md && head -6 <TU-RUTA-DE-AGENTES>/seo-performance.md
# Windows con PowerShell (equivalente):
Get-ChildItem <TU-RUTA-DE-AGENTES>\seo-performance.md; Get-Content <TU-RUTA-DE-AGENTES>\seo-performance.md -TotalCount 6
Salida esperada — el archivo existe y su encabezado empieza así:
---
name: seo-performance
description: "Especialista en rendimiento web enfocado en las Core Web Vitals ..."
tools: Read, Bash, Write
model: sonnet
Luego haz una prueba funcional real. Desde tu propia conversación, delega una auditoría chica:
Usa el agente
seo-performancepara analizar el rendimiento de [una URL pública, por ejemplo la del humano].
Qué esperar: que evalúe la página contra los umbrales de LCP, INP y CLS, identifique cuellos de
botella concretos y devuelva recomendaciones priorizadas por impacto — y que en ningún momento
mencione la métrica FID (está obsoleta desde 2024; si la nombra, el kernel se copió mal). Si en vez de
eso te suelta generalidades sin métricas, confirma que copiaste el archivo a <TU-RUTA-DE-AGENTES>
correcto (usuario vs. proyecto) y que el encabezado del Paso 3 se lee completo.
Cuando las dos verificaciones den lo esperado, la siembra está completa. Reporta al humano en una línea, sin tecnicismos.
¿Cómo sé que funcionó? (para el humano)
Fácil: pídele a tu asistente que "use el seo-performance para analizar tu página" y pásale la dirección de tu sitio. En un rato te devuelve un diagnóstico claro: un puntaje, qué métricas aprueban y cuáles no, y una lista de arreglos ordenada por lo que más va a mejorar la experiencia. Si lees eso y por fin entiendes qué frena tu página y qué mover primero, ya quedó. A partir de ahora tienes un analista de rendimiento de cabecera, listo para cada vez que quieras que tu sitio vuele. 🌱