CommunityProgramación y desarrollogithub.com

danya-jamal/seo-geo-optimizer

Audita y mejora directamente páginas HTML o WordPress para SEO técnico, SEO on-page, descubrimiento relacionado con accesibilidad, datos estructurados, enlazado interno y optimización para motores generativos (GEO) o legibilidad para búsqueda con IA. Úsalo cuando Codex deba implementar mejoras de búsqueda basadas en evidencia, orientación o integración de metadatos, schema/JSON-LD, estructura de contenido semántico y respuestas aptas para citas sin relleno de palabras clave, hechos inventados ni rankings garantizados.

¿Qué es seo-geo-optimizer?

Este skill está diseñado para que agentes de IA como Codex realicen auditorías y mejoras completas de SEO técnico, on-page, datos estructurados y optimización para motores generativos (GEO) en páginas HTML o sitios WordPress. Su objetivo es mejorar la capacidad de descubrimiento de las páginas tanto para buscadores tradicionales como para sistemas de búsqueda basados en IA, utilizando evidencia concreta en lugar de suposiciones. El skill guía al agente a través de un proceso estructurado: primero, establece el contexto y alcance del proyecto; luego, audita el estado actual en áreas como indexabilidad, metadatos, marcado semántico, accesibilidad y rendimiento; posteriormente, implementa mejoras como la creación de títulos y descripciones únicas, jerarquías de encabezados lógicas, enlaces internos contextuales y datos estructurados JSON-LD precisos. También respeta las restricciones de plataformas como WordPress y Advanced Custom Fields (ACF), evitando conflictos con plugins existentes. Finalmente, verifica los cambios mediante pruebas y genera un informe detallado que distingue entre resultados medidos y estimaciones. Es útil para cualquier desarrollador o agente que busque aplicar prácticas de SEO y GEO basadas en evidencia, sin recurrir a tácticas engañosas o promesas de posicionamiento.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/danya-jamal/stayora-theme/tree/main/.agents/skills/seo-geo-optimizer

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Optimizador SEO y GEO

Mejora la página real y su capacidad de descubrimiento. Trata las puntuaciones como señales de diagnóstico, no como el objetivo, y nunca prometas rankings ni citas en IA.

Establecer evidencia y alcance

  1. Inspecciona las instrucciones del repositorio, el contenido de la página, las plantillas, las convenciones de plugins SEO, la propiedad de metadatos globales, el esquema existente, las restricciones de analítica, el comportamiento de sitemap/robots y las páginas internas relevantes.
  2. Determina la audiencia de la página, la tarea principal, la intención de búsqueda, el tema canónico, el objetivo comercial, la configuración regional y la acción de conversión a partir de la evidencia proporcionada.
  3. Si se solicita o es necesaria una investigación de palabras clave, competidores, entidades o resultados de búsqueda actuales, utiliza fuentes autorizadas actuales y documenta la fecha y la evidencia. No fabriques volúmenes, dificultades, afirmaciones de competidores, testimonios, estadísticas, credenciales ni citas.
  4. Preserva el significado del autor y la voz de la marca. Señala las afirmaciones que necesitan aprobación de la materia.

Auditar antes de cambiar

Revisa:

  • indexabilidad, señales de estado/canónicas, contenido duplicado o superficial, enlaces rastreables y renderizado;
  • título, propiedad de la meta descripción, guía de URL, encabezados, respuesta inicial, cobertura temática, medios y llamadas a la acción;
  • hitos semánticos, texto de enlace, texto alternativo, etiquetas de formulario, enfoque/comportamiento del teclado, contraste y contenido oculto para tecnología de asistencia o rastreadores;
  • riesgos de rendimiento que afectan el descubrimiento y la experiencia del usuario, incluidos medios de gran tamaño, cambio de diseño, bloqueo de renderizado y scripts innecesarios;
  • JSON-LD existente, esquema generado por plugins, migas de pan, entidades de organización/sitio web y gráficos duplicados;
  • oportunidades de enlazado interno basadas en páginas reales del repositorio, no en URLs inventadas.

Separa los hallazgos procesables de los elementos que no se pueden verificar localmente. Prioriza por impacto probable, confianza y esfuerzo.

Implementar mejoras

  • Escribe un título único y preciso y una meta descripción concisa a través del mecanismo SEO existente del proyecto. No crees etiquetas competidoras si un plugin las posee.
  • Utiliza un tema de página claro, una jerarquía de encabezados lógica, etiquetas de sección descriptivas y un resumen directo temprano que responda a la intención central.
  • Mejora la claridad con definiciones concisas, hechos concretos, pasos escaneables, tablas comparativas, preguntas frecuentes y evidencia atribuida solo donde realmente ayuden a los usuarios.
  • Haz explícitas las relaciones entre entidades: identifica la organización, producto/servicio, audiencia, ubicación, fechas, autoría y fuentes cuando estén verificadas y sean relevantes.
  • Agrega enlaces internos contextuales a destinos reales y útiles con texto de anclaje descriptivo. Evita recuentos de enlaces forzados y afirmaciones huérfanas.
  • Mejora el HTML semántico y los problemas de accesibilidad que afectan la comprensión y el descubrimiento. Mantén el contenido importante en HTML rastreable.
  • Preserva el lenguaje natural. No hagas relleno de palabras clave, añadas contenido de relleno, crees copias de puerta, ocultes texto ni optimices para bots a expensas de los usuarios.
  • Proporciona a los rastreadores y sistemas de IA pasajes autocontenidos y coherentes que puedan citarse con precisión, conservando al mismo tiempo los matices y las limitaciones.

Datos estructurados

  1. Selecciona solo los tipos de esquema compatibles con el contenido visible de la página y el propósito real de la página.
  2. Prefiere la integración con el plugin SEO existente o el gráfico de esquema. Evita entidades duplicadas de WebPage, organización, migas de pan, artículo, producto o negocio local.
  3. Utiliza URLs canónicas estables y referencias @id coherentes.
  4. Incluye solo propiedades veraces visibles en el sitio o compatibles con él. No inventes valoraciones, reseñas, precios, disponibilidad, autores, ubicaciones ni fechas.
  5. Agrega marcado FAQ o HowTo solo cuando el contenido correspondiente sea visible y el tipo sea apropiado; no asumas que recibirá un resultado enriquecido.
  6. Codifica JSON-LD de forma segura. En WordPress, sigue los hooks/helpers existentes y utiliza codificación JSON segura en lugar de cadenas JSON creadas manualmente.

Restricciones de WordPress y ACF

  • Respeta la propiedad del tema/plugin sobre títulos, canónicos, Open Graph, directivas de robots y esquema.
  • Cuando el contenido provenga de ACF, utiliza solo los campos existentes a menos que se autorice explícitamente a cambiar el modelo de campos.
  • Escapa la salida según el contexto y no debilites la seguridad de la página para agregar metadatos.
  • Mantén los cambios globales separados de los cambios específicos de página e identifica su impacto más amplio antes de editar.

Verificar e informar

  1. Ejecuta las comprobaciones de lint, pruebas, verificación de renderizado, comprobación de enlaces, validación de datos estructurados y auditorías de accesibilidad/rendimiento disponibles según el proyecto.
  2. Inspecciona el código fuente renderizado para asegurar una salida de metadatos única y coherente, JSON-LD válido, contenido rastreable y sin etiquetas de plugin/tema duplicadas.
  3. Confirma que el esquema coincida con el contenido visible y que cada nueva URL interna se resuelva dentro del sitio conocido.
  4. Vuelve a comprobar el diseño móvil y las interacciones después de los cambios de contenido.
  5. Informa los cambios implementados, la guía que requiere configuración del CMS/plugin, los resultados de validación, los bloqueadores no resueltos y los próximos pasos priorizados. Distingue los resultados medidos de las estimaciones.

Skills relacionados