seo-audit

Visión general de la skill seo-audit

Qué hace la skill seo-audit

La skill seo-audit ayuda a un agente a realizar una revisión SEO estructurada en lugar de lanzarse directamente a consejos genéricos. Está diseñada para diagnosticar por qué un sitio rinde por debajo de lo esperado en búsqueda orgánica, qué conviene revisar primero y cómo convertir los hallazgos en un plan de acción priorizado.

Quién debería instalar esta skill seo-audit

Mejor encaje:

• marketers y founders que quieren un flujo repetible para diagnosticar SEO
• agentes que auditan sitios SaaS, de contenidos o corporativos
• equipos que lidian con caídas de tráfico, problemas de indexación, rankings débiles o problemas on-page poco claros
• cualquiera que quiera una seo-audit guide más sólida que un prompt aislado

Menos recomendable para:

• usuarios que buscan específicamente solo detalles de implementación de schema
• usuarios que hacen generación programática de páginas SEO
• usuarios centrados en optimización para búsqueda con IA en lugar de auditoría de búsqueda clásica

El trabajo real que resuelve

La mayoría de las personas que piden una auditoría SEO no quieren solo una checklist. Quieren saber:

• qué es lo más probable que esté bloqueando los rankings
• qué evidencia conviene reunir primero
• qué no se debe afirmar sin el acceso adecuado
• qué problemas importan más ahora mismo

Esta skill es útil porque impone un orden de auditoría: primero rastreabilidad e indexación, después fundamentos técnicos, optimización on-page, calidad del contenido y autoridad o enlaces. Esa secuencia evita que recomendaciones de poco valor desplacen problemas más serios de salud del sitio.

Qué diferencia a esta skill de un prompt genérico

Los diferenciadores prácticos son:

• indica al agente que primero revise el contexto de product marketing si existe un archivo de contexto local
• pide el contexto de negocio y del sitio que falte antes de auditar a ciegas
• utiliza un orden claro de prioridad para los hallazgos
• advierte explícitamente de una limitación al detectar schema markup cuando solo se depende del HTML obtenido por fetch
• espera una estructura de informe con resumen ejecutivo y acciones priorizadas

Estos detalles importan porque muchas auditorías SEO flojas suenan seguras de sí mismas mientras omiten lo básico de indexación o exageran lo que realmente puede verificarse con acceso limitado.

Cómo usar la skill seo-audit

Contexto de instalación de seo-audit

Instálala desde el repo con:

npx skills add https://github.com/coreyhaines31/marketingskills --skill seo-audit

Esto añade la skill desde skills/seo-audit en el repositorio coreyhaines31/marketingskills. No hay un instalador independiente dentro de la propia skill, así que el paso práctico de seo-audit install es el comando estándar de Skills mostrado arriba.

Lee estos archivos antes del primer uso

Para una lectura rápida del repositorio con buena señal, abre:

1. skills/seo-audit/SKILL.md
2. skills/seo-audit/evals/evals.json
3. skills/seo-audit/references/ai-writing-detection.md

Por qué en este orden:

• SKILL.md aporta el flujo y el alcance de la auditoría
• evals/evals.json muestra cómo es una buena ejecución
• la referencia de redacción ayuda a que la salida de la auditoría sea más legible y menos sintética, algo importante si vas a compartir hallazgos con clientes o stakeholders

Qué inputs necesita la skill

La calidad de seo-audit usage depende mucho de los datos que proporciones. Como mínimo, incluye:

• la URL del sitio
• tipo de sitio: SaaS, e-commerce, publisher, negocio local, marketplace, etc.
• objetivo SEO: más leads, más tráfico orgánico no de marca, recuperación tras una caída, mejores rankings para páginas clave
• keywords objetivo o clusters temáticos
• problemas conocidos: migración, rediseño, cambio de CMS, pérdida de tráfico, quejas de indexación
• alcance: sitio completo, sección, plantilla o una sola página
• nivel de acceso: solo web pública, datos de Search Console, analytics, exports de crawls, URLs de competidores

Si omites esto, la skill seguirá siendo útil, pero el resultado tenderá a centrarse en comprobaciones on-page visibles y heurísticas técnicas amplias.

Revisa el contexto local antes de hacer preguntas

Una de las partes más útiles —y fáciles de pasar por alto— de esta skill seo-audit es la instrucción de leer primero .agents/product-marketing-context.md o .claude/product-marketing-context.md si existen. Si usas la skill dentro de un repo de proyecto, esto puede eliminar el típico ida y vuelta sobre audiencia, posicionamiento y páginas prioritarias.

Eso mejora la calidad de la auditoría porque las recomendaciones SEO son mucho mejores cuando se conectan con el producto real, el funnel y el mercado.

Convierte una petición vaga en un prompt de auditoría sólido

Input débil:

• "Do an SEO audit of our site"

Input más sólido:

• "Run an SEO audit for https://example.com. We are a B2B SaaS company selling payroll software for remote teams. Primary goal is demo signups from non-brand organic search. Priority keywords are global payroll software, employer of record payroll, and multi-country payroll. Organic traffic dropped about 25% after a site redesign six weeks ago. Focus on crawlability, indexation, title and heading quality, internal linking, and content gaps on money pages. If something cannot be verified from public fetch alone, say so clearly."

Por qué funciona:

• aporta contexto de negocio
• define qué significa éxito
• acota el alcance
• favorece la incertidumbre basada en evidencia en lugar de una falsa certeza

Sigue el orden de auditoría previsto

Un error habitual es empezar por ajustes de copy. Esta skill aporta más valor si se usa en la secuencia para la que fue diseñada:

1. Rastreabilidad e indexación
2. Fundamentos técnicos
3. Optimización on-page
4. Calidad del contenido
5. Autoridad y enlaces

Ese orden cambia el resultado. Si las páginas están bloqueadas, mal canonicalizadas o pobremente enlazadas, reescribir meta descriptions no va a resolver el problema de fondo.

Qué debería inspeccionar la skill en la práctica

Por las señales del repositorio y las expectativas de los evals, un buen seo-audit usage debería incluir comprobaciones como:

• robots.txt
• presencia y calidad del sitemap XML
• señales de indexación y rastreo
• arquitectura del sitio y lógica de enlazado interno
• title tags y meta descriptions
• estructura de headings
• relevancia y optimización del contenido
• posibles problemas técnicos que afecten a la descubribilidad o al rendimiento

Después, debería organizar los hallazgos en un informe útil para tomar decisiones, no en una lista plana de observaciones.

Respeta la limitación en la detección de schema

Este es un detalle real de adopción, no una nota menor. La skill advierte explícitamente que no se debe afirmar "no schema markup found" basándose solo en resultados básicos de fetch de la página. Muchos sitios inyectan schema del lado del cliente o de formas que un fetch simple no detecta.

Una buena salida debería decir algo como:

• "Schema markup could not be reliably verified from current fetch-based inspection."
• "Validate with rendered HTML, source inspection, or a schema testing workflow before concluding it is missing."

Esto hace que la seo-audit skill sea más fiable que auditorías que exageran su nivel de certeza.

Usa la estructura de informe esperada

Para que la entrega sea útil en la práctica, haz que la skill produzca:

• Executive Summary
• Technical SEO Findings
• On-Page SEO Findings
• Content Findings
• Prioritized Action Plan

Esto importa porque los stakeholders rara vez actúan sobre notas en bruto. Actúan sobre problemas ordenados por prioridad, con justificación, impacto y siguientes pasos.

Usa los evals para juzgar la calidad del resultado

skills/seo-audit/evals/evals.json es uno de los mejores archivos para decidir si vale la pena confiar en esta skill y seguir usándola. Muestra los comportamientos esperados:

• hacer preguntas de aclaración cuando falta contexto
• priorizar la rastreabilidad antes que el pulido del contenido
• revisar lo básico de robots y sitemap
• evitar afirmaciones sobre schema sin sustento
• presentar hallazgos en una estructura utilizable

Si tu agente no está haciendo eso, en realidad no está siguiendo bien la skill.

Preguntas frecuentes sobre la skill seo-audit

¿Esta skill seo-audit es buena para principiantes?

Sí, especialmente para principiantes que necesitan una secuencia de auditoría sensata. Ayuda a evitar revisiones SEO aleatorias y ofrece un marco inicial más claro. Aun así, quienes empiezan deben aportar contexto de negocio, porque la skill no sustituye saber qué páginas y consultas importan.

¿En qué se diferencia de pedirle directamente a una IA una auditoría SEO?

Un prompt normal puede devolver una lista plausible de consejos SEO. Esta skill es mejor cuando quieres:

• un orden de auditoría definido
• mejores preguntas para acotar el trabajo
• menos afirmaciones no sustentadas
• un informe final más útil

La mayor ventaja práctica no es "más funciones". Es menos improvisación y mejor priorización.

¿Puedo usar seo-audit para trabajo de SEO Content?

Sí, pero con la expectativa correcta. La skill permite seo-audit for SEO Content al revisar optimización on-page, calidad del contenido y posibles problemas de relevancia. No está pensada principalmente para generar content briefs. Úsala para diagnosticar si las páginas existentes están alineadas con la intención de búsqueda, los metadatos, los headings y la estructura del sitio antes de decidir qué contenido reescribir o crear.

¿Requiere acceso a Search Console o analytics?

No. Puedes usarla solo con inspección pública del sitio. Pero el techo de calidad es más bajo. Sin Search Console, analytics o exports de crawls, la skill puede identificar problemas probables, no validar por completo cada afirmación sobre rendimiento o indexación.

¿Cuándo no debería usar esta skill?

Omite esta skill si tu necesidad principal es:

• añadir o depurar solo schema markup
• generación masiva de páginas para cubrir keywords
• estrategia de visibilidad en buscadores con IA en lugar de diagnóstico SEO clásico

También encaja mal cuando el usuario quiere implementación inmediata de correcciones sin entender primero el problema subyacente.

¿La referencia de redacción realmente es relevante?

Sí, si la salida de la auditoría va a ser de cara al cliente o se va a publicar internamente. La referencia en references/ai-writing-detection.md no es un archivo de framework SEO, pero sí mejora la calidad de la entrega. Las recomendaciones más limpias y menos obviamente generadas por máquina suelen ser más fáciles de adoptar y en las que los equipos más confían.

Cómo mejorar la skill seo-audit

Dale a la skill mejor contexto de negocio

La forma más rápida de mejorar la seo-audit skill es dejar de tratarla como si fuera un escáner genérico. Dile:

• quién es la audiencia
• qué páginas importan más
• qué evento de conversión importa
• qué cambió recientemente
• qué consultas te interesan

Esto transforma la auditoría de "observaciones SEO" en "decisiones SEO".

Acota el alcance cuando el sitio es grande

En sitios grandes, pide una de estas opciones en lugar de una auditoría completa vaga:

• homepage más las 5 páginas con mayor impacto en ingresos
• un directorio o sección del blog
• un tipo de plantilla
• un cluster con pérdida de tráfico

Los alcances más pequeños producen hallazgos más precisos y recomendaciones más accionables.

Pide evidencia y etiquetas de incertidumbre

Para evitar una salida superficial, solicita:

• problema observado
• por qué importa
• nivel de confianza
• corrección recomendada
• impacto esperado
• qué requiere validación adicional

Esto es especialmente útil para afirmaciones técnicas y de indexación, donde la inspección pública puede ser incompleta.

Evita recomendaciones poco profundas

Modo de fallo común: la primera salida se centra demasiado en títulos, keywords y consejos genéricos de "mejorar la calidad del contenido".

Corrígelo pidiendo:

• primero bloqueadores de rastreo e indexación
• patrones por plantilla de página, no solo detalles minúsculos de una página
• rutas de enlazado interno hacia páginas prioritarias
• desajustes entre intención de negocio y tipos de página que posicionan

Así mantienes el seo-audit centrado en palancas de impacto, no en retoques cosméticos.

Aporta ejemplos de páginas fuertes y débiles

Si sabes qué páginas funcionan bien y cuáles no, comparte ambas. La skill podrá comparar:

• formato de title
• profundidad de headings
• estructura del contenido
• enlaces internos
• ajuste con la intención
• alineación con la conversión

La entrada comparativa suele generar mejores recomendaciones que pedir una auditoría en frío de todo el dominio.

Itera después de la primera auditoría

La primera pasada normalmente debería producir una lista priorizada, no la hoja de ruta final. Algunos buenos prompts de seguimiento son:

• "Expand only the top 3 technical issues with validation steps."
• "Turn the content findings into page-specific rewrite priorities."
• "Separate quick wins from engineering-heavy fixes."
• "Map each recommendation to likely impact and effort."

Esta es la mejor forma de convertir seo-audit usage en un plan de ejecución.

Vigila las afirmaciones excesivas con acceso limitado

Si el agente no puede hacer crawl, renderizar JavaScript o inspeccionar la configuración de la plataforma, no dejes que hable como si tuviera visibilidad total. La skill ya apunta en la dirección correcta aquí. Mantén esa cautela. Mejora la confianza y reduce falsos positivos.

Usa la salida como capa de triaje

Esta seo-audit guide funciona mejor como una primera capa de diagnóstico antes del trabajo de especialistas. Úsala para:

• identificar bloqueadores probables
• priorizar líneas de investigación
• preparar resúmenes para stakeholders
• decidir si necesitas SEO técnico más profundo, trabajo de contenido o soporte de implementación

Ese es un papel más sólido que esperar que la skill, por sí sola, sustituya herramientas SEO completas o acceso en vivo al sitio.