SEO: Habilidad de Análisis SEO Universal
Regla de Lectura Selectiva
Empieza con:
references/usage-routing.mdreferences/quality-checklist.md
Luego carga solo los documentos, scripts, activos o ejemplos heredados que coincidan con la tarea real del usuario.
Regla de Lectura Selectiva
Empieza con:
references/senior-master-standard.md
Luego carga solo las referencias, scripts, activos o ejemplos necesarios para la tarea real del usuario.
Análisis SEO integral para todas las industrias (SaaS, servicios locales, comercio electrónico, editoriales, agencias). Orquesta 12 sub-habilidades especializadas y 7 subagentes (+ sub-habilidades de extensión opcionales como seo-dataforseo).
Cuándo Usarlo
- Úsalo cuando el usuario solicite una auditoría SEO completa o una estrategia SEO amplia.
- Úsalo como punto de entrada general cuando múltiples dimensiones SEO estén involucradas.
- Úsalo cuando la tarea abarque SEO técnico, contenido, schema, sitemaps y preparación para búsqueda con IA en conjunto.
Referencia Rápida
| Comando | Qué hace |
|---|---|
/seo audit <url> | Auditoría completa del sitio con delegación paralela a subagentes |
/seo page <url> | Análisis profundo de una sola página |
/seo sitemap <url o generar> | Analizar o generar sitemaps XML |
/seo schema <url> | Detectar, validar y generar marcado Schema.org |
/seo images <url> | Análisis de optimización de imágenes |
/seo technical <url> | Auditoría SEO técnica (9 categorías) |
/seo content <url> | Análisis de calidad de contenido y E-E-A-T |
/seo geo <url> | Optimización para AI Overviews / Motores de Búsqueda Generativos |
/seo plan <tipo-de-negocio> | Planificación estratégica SEO |
| `/seo programmatic [url | plan]` |
| `/seo competitor-pages [url | generar]` |
/seo hreflang [url] | Auditoría y generación de hreflang/i18n SEO |
/seo dataforseo [comando] | Datos SEO en vivo a través de DataForSEO (extensión) |
/seo image-gen [caso-de-uso] <descripción> | Generación de imágenes con IA para activos SEO (extensión) |
Lógica de Orquestación
Cuando el usuario invoca /seo audit, delegar a los subagentes en paralelo:
- Detectar el tipo de negocio (SaaS, local, ecommerce, editorial, agencia, otro)
- Iniciar subagentes: seo-technical, seo-content, seo-schema, seo-sitemap, seo-performance, seo-visual, seo-geo
- Recopilar resultados y generar un informe unificado con la Puntuación de Salud SEO (0-100)
- Crear un plan de acción priorizado (Crítico -> Alta -> Media -> Baja)
Para comandos individuales, cargar la sub-habilidad relevante directamente.
Detección de Industria
Detectar el tipo de negocio a partir de las señales de la página de inicio:
- SaaS: página de precios, /features, /integrations, /docs, "prueba gratuita", "registrarse"
- Servicio Local: número de teléfono, dirección, área de servicio, "sirviendo a [ciudad]", mapa de Google Maps incrustado
- Comercio Electrónico: /products, /collections, /cart, "añadir al carrito", schema de producto
- Editorial: /blog, /articles, /topics, schema de artículo, páginas de autor, fechas de publicación
- Agencia: /case-studies, /portfolio, /industries, "nuestro trabajo", logotipos de clientes
Puertas de Calidad
Lee references/quality-gates.md para conocer los umbrales de contenido fino por tipo de página.
Reglas estrictas:
- ADVERTENCIA a partir de 30 páginas de ubicación (exigir 60%+ de contenido único)
- DETENCIÓN TOTAL a partir de 50 páginas de ubicación (requerir justificación del usuario)
- Nunca recomendar schema HowTo (obsoleto desde septiembre de 2023)
- Schema FAQ para resultados enriquecidos de Google: solo sitios gubernamentales y de atención médica (restricción de agosto de 2023); FAQPage existente en sitios comerciales -> marcar como prioridad Info (no Crítica), teniendo en cuenta el beneficio de citación de IA/LLM; agregar nuevo FAQPage -> no recomendado para beneficio de Google
- Todas las referencias a Core Web Vitals usan INP, nunca FID
Archivos de Referencia
Cargar bajo demanda según sea necesario (NO cargar todos al inicio):
references/cwv-thresholds.md: Umbrales actuales de Core Web Vitals y detalles de mediciónreferences/schema-types.md: Todos los tipos de schema compatibles con estado de obsolescenciareferences/eeat-framework.md: Criterios de evaluación E-E-A-T (actualización QRG de septiembre de 2025)references/quality-gates.md: Mínimos de longitud de contenido, umbrales de unicidad
Metodología de Puntuación
Puntuación de Salud SEO (0-100)
Agregado ponderado de todas las categorías:
| Categoría | Peso |
|---|---|
| SEO Técnico | 22% |
| Calidad del Contenido | 23% |
| SEO On-Page | 20% |
| Schema / Datos Estructurados | 10% |
| Rendimiento (CWV) | 10% |
| Preparación para Búsqueda con IA | 10% |
| Imágenes | 5% |
Niveles de Prioridad
- Crítico: Bloquea la indexación o causa penalizaciones (corrección inmediata requerida)
- Alta: Impacta significativamente el ranking (corregir en 1 semana)
- Media: Oportunidad de optimización (corregir en 1 mes)
- Baja: Bueno tener (pendiente)
Sub-Habilidades
Esta habilidad orquesta 12 sub-habilidades especializadas (+ 2 extensiones):
- seo-audit -- Auditoría completa del sitio con delegación paralela
- seo-page -- Análisis profundo de una sola página
- seo-technical -- SEO técnico (9 categorías)
- seo-content -- E-E-A-T y calidad del contenido
- seo-schema -- Detección y generación de marcado Schema
- seo-images -- Optimización de imágenes
- seo-sitemap -- Análisis y generación de sitemaps
- seo-geo -- Optimización para AI Overviews / GEO
- seo-plan -- Planificación estratégica con plantillas
- seo-programmatic -- Análisis y planificación SEO programática
- seo-competitor-pages -- Generación de páginas de comparación de competidores
- seo-hreflang -- Auditoría y generación de hreflang/i18n SEO
- seo-dataforseo -- Datos SEO en vivo a través de DataForSEO MCP (extensión)
- seo-image-gen -- Generación de imágenes con IA para activos SEO a través de Gemini (extensión)
Subagentes
Para análisis paralelo durante auditorías:
seo-technical-- Rastreabilidad, indexabilidad, seguridad, CWVseo-content-- E-E-A-T, legibilidad, contenido finoseo-schema-- Detección, validación, generaciónseo-sitemap-- Estructura, cobertura, puertas de calidadseo-performance-- Medición de Core Web Vitalsseo-visual-- Capturas de pantalla, pruebas móviles, contenido visible sin desplazarseo-geo-- Acceso de rastreadores de IA, llms.txt, citabilidad, señales de mención de marcaseo-dataforseo-- Datos SERP, palabras clave, backlinks y SEO local en vivo (extensión, opcional)seo-image-gen-- Auditoría de imágenes SEO y plan de generación (extensión, opcional)
Manejo de Errores
| Escenario | Acción |
|---|---|
| Comando no reconocido | Listar los comandos disponibles de la tabla de Referencia Rápida. Sugerir el comando más cercano. |
| URL inalcanzable | Reportar el error y sugerir al usuario que verifique la URL. No intentar adivinar el contenido del sitio. |
| Sub-habilidad falla durante la auditoría | Reportar resultados parciales de las sub-habilidades exitosas. Indicar claramente qué sub-habilidad falló y por qué. Sugerir volver a ejecutar la sub-habilidad fallida de forma individual. |
| Detección ambigua del tipo de negocio | Presentar los dos tipos principales detectados con las señales de soporte. Preguntar al usuario para confirmar antes de proceder con recomendaciones específicas de la industria. |
Limitaciones
- Usar esta habilidad solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
- No tratar el resultado como un sustituto de la validación específica del entorno, las pruebas o la revisión de expertos.
- Detenerse y pedir aclaraciones si faltan las entradas requeridas, los permisos, los límites de seguridad o los criterios de éxito.