on-page-seo-auditor

Visión general de la skill on-page-seo-auditor

Qué hace la skill on-page-seo-auditor

La skill on-page-seo-auditor evalúa el SEO on-page de una sola página y convierte la revisión en un informe con puntuación y correcciones priorizadas. Se centra en los elementos que los equipos suelen necesitar primero cuando una página no rinde como debería: title tag, meta description, encabezados, calidad del contenido, uso de palabras clave, enlaces internos, imágenes y señales técnicas básicas.

Quién debería usarla

Esta skill encaja especialmente bien para especialistas SEO, equipos de content marketing, editores, growth teams y propietarios de sitios que quieren una auditoría estructurada de página sin tener que construir una rúbrica manual cada vez. Resulta especialmente útil cuando la pregunta real no es “enséñame SEO”, sino “dime por qué esta página no posiciona y qué debo corregir primero”.

Trabajo que resuelve

La mayoría de los usuarios adoptan on-page-seo-auditor para diagnosticar una URL frente a una palabra clave objetivo y salir con una lista de acciones que puedan pasar a un redactor, editor o desarrollador. El valor no está solo en un checklist. Está en la combinación de:

• un modelo de puntuación repetible
• análisis por secciones
• prioridades de corrección
• plantillas de salida que mantienen consistentes las auditorías entre páginas

Qué hace diferente a esta skill

Frente a un prompt genérico como “audita esta página”, la skill on-page-seo-auditor tiene una estructura operativa más sólida. El repositorio incluye:

• un ejemplo de auditoría resuelto en references/audit-example.md
• patrones de salida reutilizables en references/audit-templates.md
• un sistema de puntuación en references/scoring-rubric.md

Esto importa si necesitas auditorías comparables en el tiempo o entre distintas URLs, y no solo comentarios aislados.

Casos ideales y casos en los que no encaja

Mejor encaje:

• auditar una landing page, artículo de blog, roundup, product page o una URL similar
• comprobar si una página está alineada con una palabra clave principal y con la intención de búsqueda
• crear un brief práctico de optimización para actualizar contenido

Menos recomendable para:

• crawling de un sitio completo
• auditorías SEO técnicas profundas
• análisis de logs, depuración de indexación o trabajo de backlinks
• situaciones en las que no puedes proporcionar la URL o el contenido de la página

Cómo usar la skill on-page-seo-auditor

Contexto de instalación de on-page-seo-auditor

El repositorio no expone un comando de instalación específico de la skill en SKILL.md, así que la mayoría de usuarios la instala desde la colección principal de skills y luego la invoca por nombre desde su entorno de skills de IA. El patrón de instalación habitual es:

npx skills add aaron-he-zhu/seo-geo-claude-skills --skill on-page-seo-auditor

La skill declara compatibilidad con Claude Code, skills.sh marketplace, ClawHub y el ecosistema de skills de Vercel Labs. No requiere paquetes de sistema. WebFetch es la herramienta permitida clave, y el acceso opcional a red/MCP puede ayudar si tu configuración admite tooling SEO externo.

Qué entradas necesita la skill

Para obtener una salida útil, dale a la skill algo más que una URL. Como mínimo, proporciona:

• la URL de la página
• la palabra clave principal objetivo
• el tipo de página, si lo conoces
• cualquier palabra clave secundaria importante
• el objetivo de negocio o de conversión

Entradas opcionales especialmente útiles:

• país o idioma objetivo
• segmento de audiencia
• competidores conocidos
• si la página es informativa, comercial, transaccional o navegacional
• contexto de una caída reciente de rankings

Sin una palabra clave objetivo, la auditoría aún puede revisar la calidad de la página, pero la puntuación sobre ajuste de intención y colocación de keywords será menos concluyente.

Cómo convertir una petición vaga en un buen prompt

Prompt débil:

• “Check my page SEO”

Mejor prompt:

• “Use the on-page-seo-auditor skill to audit https://example.com/best-noise-cancelling-headphones for the keyword best noise cancelling headphones. Page type is commercial roundup. Secondary keywords: wireless noise cancelling headphones, ANC headphones. Evaluate title, meta, H1-H3 structure, content gaps, internal links, image alt text, and technical basics. Give me a scored report and top 5 fixes by impact.”

Funciona mejor porque da a la skill la consulta objetivo, la intención probable y las expectativas de salida.

Formato de prompt recomendado para equipos de SEO Content

Si estás usando on-page-seo-auditor en flujos de trabajo de SEO Content, utiliza un prompt con una estructura como esta:

• URL: ...
• Primary keyword: ...
• Secondary keywords: ...
• Page type: blog post / product page / landing page / comparison / roundup
• Audience: ...
• Market: ...
• Main conversion goal: ...
• Known issue: not ranking / rankings dropped / low CTR / weak engagement
• Output needed: scored audit + prioritized fixes + rewrite suggestions

Esto reduce la ambigüedad y mejora la priorización.

Qué suele cubrir la salida de la auditoría

Según las referencias y la rúbrica, la skill on-page-seo-auditor está diseñada para puntuar ocho secciones principales:

• title tag
• meta description
• estructura de encabezados
• calidad del contenido
• optimización de palabras clave
• enlaces internos
• imágenes
• elementos técnicos

La rúbrica de puntuación del repositorio asigna pesos, lo cual resulta útil si necesitas auditorías consistentes y no recomendaciones meramente subjetivas.

Lee primero estos archivos del repositorio

Si quieres entender cómo “piensa” la skill antes de apoyarte en ella, lee estos archivos en este orden:

1. SKILL.md
2. references/scoring-rubric.md
3. references/audit-example.md
4. references/audit-templates.md

Por qué este orden:

• SKILL.md muestra el alcance y el flujo de trabajo
• la rúbrica explica cómo se derivan las puntuaciones
• el ejemplo resuelto muestra la forma del informe final
• las plantillas te ayudan a adaptar la salida a tu propio proceso

Flujo de trabajo práctico para una auditoría de una sola página

Un flujo de uso fiable de on-page-seo-auditor suele verse así:

1. Elige una URL y una palabra clave principal.
2. Identifica el tipo de página y la intención de búsqueda más probable.
3. Ejecuta la auditoría con la URL, la keyword y el contexto.
4. Revisa las puntuaciones ponderadas, no solo la nota total.
5. Corrige primero las debilidades de mayor impacto, normalmente title, alineación con la intención, lagunas de contenido y enlazado interno.
6. Vuelve a ejecutar la auditoría tras las actualizaciones para comprobar si han mejorado la puntuación y los problemas prioritarios.

Esto funciona mejor que auditar muchas páginas de forma superficial, porque la skill es más fuerte como herramienta de diagnóstico focalizada a nivel de página.

Consejos que mejoran de verdad la calidad de la salida

Hay algunos datos de entrada que cambian de forma notable la calidad del resultado:

• Indica a la skill si la página apunta a intención informativa o comercial.
• Proporciona la keyword exacta, no solo una etiqueta temática.
• Menciona si la página es una actualización de contenido antiguo.
• Pide prioridad de corrección por impacto y esfuerzo, no solo una lista de problemas.
• Pide que separe los “quick wins” de lo que “requires rewrite”.

Estos detalles ayudan al modelo a evitar consejos SEO genéricos y a generar recomendaciones listas para implementar.

Cómo usar on-page-seo-auditor cuando han caído los rankings

Si tu caso real es “esta página antes posicionaba”, dilo de forma explícita. Incluye:

• fecha aproximada de la caída
• qué cambió en la página, si cambió algo
• si cayeron las impresiones, los clics o el CTR
• si los competidores actualizaron su contenido

La skill on-page-seo-auditor no sustituye a Search Console ni al diagnóstico de crawling, pero este contexto le ayuda a enfocar la auditoría de página en causas probables y no solo en buenas prácticas estáticas.

Límites que conviene conocer antes de instalar

Esto no es un crawler ni un sustituto completo de Screaming Frog. Se parece más a un framework estructurado de revisión de página. Eso significa:

• excelente para diagnosticar una sola página y proponer correcciones editoriales
• más débil para detectar titles duplicados en todo el sitio
• más débil para problemas de renderizado con JavaScript y SEO técnico avanzado
• dependiente del acceso al contenido de la página o de que la URL sea recuperable

Si lo que necesitas es QA a escala de portfolio o de sitio completo, esta skill funciona mejor junto a un crawler, no en su lugar.

Preguntas frecuentes sobre la skill on-page-seo-auditor

¿La skill on-page-seo-auditor es buena para principiantes?

Sí, siempre que ya sepas qué página quieres auditar. Las plantillas y la rúbrica de puntuación reducen bastante la incertidumbre. Aun así, los principiantes pueden necesitar ayuda para interpretar ciertos trade-offs, pero la skill es más usable que un prompt en blanco porque impone una estructura de auditoría.

¿Cuál es la principal ventaja frente a un prompt normal?

La diferencia principal es la consistencia. Un prompt normal puede darte una recomendación decente una vez. La skill on-page-seo-auditor te da un patrón de auditoría repetible, puntuación ponderada y ejemplos reutilizables en múltiples revisiones de contenido.

¿Puedo usar on-page-seo-auditor con cualquier tipo de página?

En general sí, pero los resultados son mejores cuando indicas el tipo de página. Un artículo de blog, una product page, una landing page y una roundup page no deberían evaluarse exactamente igual. Las referencias apuntan de forma explícita a una auditoría sensible al tipo de página.

¿Requiere herramientas SEO externas?

No. La skill puede funcionar como una auditoría estructurada sin herramientas externas. Las integraciones opcionales de red o MCP pueden ayudar en algunos entornos, pero no son necesarias para obtener recomendaciones útiles a nivel de página.

¿Es una auditoría SEO técnica completa?

No. on-page-seo-auditor se centra en factores on-page y en elementos técnicos ligeros visibles dentro de una auditoría de página. No es la herramienta adecuada para crawl budget, análisis de logs, canonicalización a escala o troubleshooting de indexación.

¿Es útil para equipos de SEO Content?

Sí. Este es uno de los mejores casos de uso de on-page-seo-auditor para SEO Content, porque convierte una revisión de calidad ambigua en un brief de optimización de contenido. Redactores y editores pueden actuar sobre recomendaciones relacionadas con encabezados, cobertura temática, colocación de keywords, enlaces internos y elementos de contenido faltantes.

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

No la uses como único flujo de trabajo cuando:

• necesitas auditorías de todo el sitio
• los problemas de ranking probablemente se deben a autoridad, enlaces o indexación
• no puedes especificar una palabra clave objetivo
• necesitas un análisis competitivo de SERP en lugar de una auditoría de página

Cómo mejorar la skill on-page-seo-auditor

Dale a on-page-seo-auditor un objetivo de búsqueda más preciso

La forma más rápida de mejorar los resultados de on-page-seo-auditor es acotar el objetivo. Usa una palabra clave principal, no un paquete de frases vagamente relacionadas. Si hay varias intenciones, ejecuta auditorías separadas o deja claramente indicada cuál es la principal.

Indica de forma explícita el tipo de página y la intención

Un fallo habitual es puntuar una página contra la intención equivocada. Por ejemplo, si una product page se evalúa como si fuera una guía informativa, las recomendaciones de contenido serán engañosas. Indica a la skill si la página es:

• informativa
• de investigación comercial
• transaccional
• local
• de marca / enfocada en navegación

Eso cambia por completo qué significa que una página esté “bien”.

Pide recomendaciones respaldadas por evidencias

Si la primera salida te parece genérica, afina el siguiente prompt:

• pídele que cite el elemento exacto de la página que provoca la puntuación
• pídele sugerencias de reescritura para title, meta, H1 y secciones débiles
• pídele una tabla de optimización antes/después
• pídele que separe los problemas observados de los inferidos

Eso empuja la skill desde “comentario SEO” hacia una “auditoría accionable”.

Mejora la utilidad de la puntuación, no solo su precisión

Los usuarios suelen fijarse demasiado en el número final. Una mejor forma de aprovechar on-page-seo-auditor es mejorar la calidad de decisión:

• qué problemas están bloqueando la relevancia
• qué problemas están deprimiendo el CTR
• qué problemas están debilitando la profundidad o la confianza
• qué correcciones son más rápidas de publicar

Pide prioridades por impacto, confianza y esfuerzo para que el informe sea más operativo.

Usa las referencias para calibrar tus expectativas

Los archivos de soporte no son relleno. Mejoran de forma material el uso:

• references/scoring-rubric.md te ayuda a entender por qué una página obtuvo mala puntuación
• references/audit-example.md muestra el nivel de especificidad esperado
• references/audit-templates.md te ayuda a estandarizar salidas en un equipo

Si la primera ejecución te parece demasiado superficial, compárala con el ejemplo resuelto y ajusta tu prompt para que siga esa estructura.

Fallos habituales de on-page-seo-auditor que conviene vigilar

Las salidas flojas suelen venir de entradas flojas:

• no indicar keyword objetivo
• no indicar el tipo de página
• no dar contexto de audiencia o mercado
• pedir “todo lo que está mal” en vez de correcciones priorizadas
• esperar conclusiones de todo el sitio a partir de una sola URL

La mayoría de los malos resultados son problemas de cómo se plantea el prompt, no del repositorio.

Cómo iterar con on-page-seo-auditor después de la primera auditoría

A menudo, un buen prompt de segunda pasada funciona mejor que un primer prompt más largo. Tras el informe inicial, pide por ejemplo:

• “Re-rank the issues by likely ranking impact.”
• “Rewrite the title, meta description, and H1 based on this audit.”
• “Turn the content gaps into an editor brief.”
• “Give me only quick wins I can ship today.”
• “Re-audit after these edits and compare score changes.”

Esto convierte la skill on-page-seo-auditor en un flujo de revisión iterativa y no en un diagnóstico de una sola vez.

La mejor forma de usar on-page-seo-auditor con otras skills

Esta skill combina bien con skills de keyword research, content brief y reescritura. Úsala después de decidir el targeting de keywords, pero antes o durante las revisiones de página. En la práctica:

1. elige la keyword
2. audita la página
3. reescribe los elementos on-page débiles
4. vuelve a auditar para comprobar la consistencia

Esa secuencia suele ser más productiva que intentar auditar antes de tener clara la consulta objetivo de la página.