Crea un conjunto de habilidades de investigación SEO que funcione en varias herramientas de agentes de IA

## Escribe cada habilidad una sola vez con funciones que entiendan todas las herramientas Redacte cada habilidad de investigación en una fuente canónica e independiente de la plataforma. Limite el contrato básico a funciones que todos los entornos de agentes previstos puedan interpretar. Exija que cada definición de habilidad proporcione: - un nombre estable y una descripción clara; - declaraciones opcionales de modelo y herramientas solo cuando el host las admita; - instrucciones operativas completas en el cuerpo; - entradas, resultados, restricciones y condiciones de fallo explícitos. Trate los controles específicos de una plataforma como extensiones opcionales. Un comprobador de compatibilidad debe advertir cuando un host pueda ignorar una extensión sin tener que rechazar una habilidad que, por lo demás, sea portátil. Edite la fuente canónica en vez de las copias de plataforma generadas. Valide todas las definiciones de habilidades antes de empaquetarlas o distribuirlas, para detectar pronto los metadatos ausentes y la sintaxis no admitida. ## Averigua dónde busca cada herramienta de agentes de IA sus instrucciones y habilidades Determine cómo descubre cada entorno de destino las instrucciones del proyecto y las habilidades reutilizables. Los patrones habituales incluyen archivos de instrucciones en la raíz, directorios de reglas dedicados, carpetas de habilidades nativas, despachadores generados y vías alternativas basadas en documentación. Registre para cada host: - qué archivo se lee automáticamente al iniciar una sesión; - dónde deben copiarse, enlazarse o instalarse las habilidades reutilizables; - si la activación es automática o requiere un comando explícito; - cómo se pasa a la ejecución en línea cuando no se admite la delegación; - qué documentación del proyecto actúa como última vía alternativa. No suponga que una sola disposición de instalación funciona en todas partes. Mantenga una única fuente semántica mientras adapta el descubrimiento, la activación y el empaquetado al comportamiento verificado del host. ## Describe los pasos como acciones simples y tradúcelos a los nombres de cada herramienta Escriba los procedimientos en términos de operaciones neutrales, como leer, escribir, editar, ejecutar comandos, enumerar archivos, buscar texto y obtener contenido web. Mantenga un mapa de compatibilidad verificado entre esas operaciones y los nombres de herramientas de cada host. Deje que los adaptadores traduzcan los alias cuando el host admita el mapeo automático. Si una capacidad no está disponible, defina una alternativa documentada en lugar de omitir el paso silenciosamente. Mantenga la traducción de herramientas separada de la lógica de investigación. Un procedimiento de análisis de páginas debe indicar que necesita una obtención protegida y un analizador HTML, sin depender de las etiquetas de herramientas de un proveedor. Revise los mapeos cada vez que un host cambie su interfaz de herramientas. No afirme que existe compatibilidad solo porque los nombres se parecen; pruebe la operación mapeada. ## Haz que una pequeña habilidad principal elija qué habilidad de investigación cargar Use un orquestador pequeño para clasificar la solicitud y cargar únicamente la capacidad pertinente. Mantenga la lógica de análisis detallada en módulos específicos en vez de concentrarla en un archivo de instrucciones sobredimensionado. Separe el sistema en: - una habilidad de enrutamiento que seleccione el flujo de trabajo; - habilidades de investigación específicas con criterios de análisis completos; - agentes especialistas opcionales para trabajos independientes o paralelos; - scripts locales para una ejecución determinista; - plantillas de esquema para metadatos de búsqueda estructurados; - adaptadores para el empaquetado específico de cada host; - extensiones para proveedores opcionales y capacidades costosas. Mantenga las extensiones fuera de la ruta de dependencias principal. La ausencia de una extensión debe reducir la cobertura opcional sin impedir la investigación básica. ## Elige el análisis SEO más acotado para cada pregunta Seleccione la capacidad de menor alcance que responda a la pregunta de investigación: - use una auditoría completa del sitio para descubrir y priorizar problemas de forma amplia; - use un análisis de una sola página para examinar en profundidad una URL; - use un análisis técnico para la rastreabilidad, la indexación, el rendimiento y la infraestructura relacionada; - use un análisis de contenido para las señales de calidad, confianza, conocimientos especializados y experiencia; - use un análisis de datos estructurados para detectar, validar y generar; - use un análisis del mapa del sitio para la cobertura y la generación de XML; - use un análisis de imágenes para los metadatos de página, la visibilidad en resultados de búsqueda y la optimización de archivos; - use un análisis de búsqueda con IA para la visibilidad generativa y la optimización para motores de respuestas. Amplíe a una auditoría más extensa únicamente cuando los hallazgos crucen varios límites de capacidad. Conserve la URL original, la fuente de la evidencia, el momento de observación y la incertidumbre de cada afirmación externa. ## Separa la planificación SEO y sigue los cambios frente a un punto de partida Proporcione flujos distintos para la planificación estratégica, la agrupación semántica de palabras clave, el análisis de la experiencia de búsqueda y la arquitectura de contenido. No combine estas tareas de planificación con los diagnósticos técnicos. Mantenga explícito el estado de la supervisión: 1. capture una referencia estable; 2. compare una observación posterior con esa referencia; 3. conserve el historial para distinguir los cambios repetidos del ruido puntual. Use módulos especializados para comercio, páginas de destino programáticas, páginas de comparación con competidores, búsqueda local, visibilidad en mapas, segmentación internacional por idioma, datos de búsqueda propios, experiencia de página y análisis de enlaces entrantes. Trate los proveedores de datos externos, el rastreo a gran escala y la generación de recursos como extensiones opcionales. Indique los requisitos del proveedor, las credenciales, el coste y los límites de cobertura antes de invocarlos. ## Revisa las URL antes de descargarlas y no pongas claves de API en las habilidades Use scripts locales para trabajos deterministas, como la obtención protegida de páginas, el análisis de HTML, las comprobaciones de rendimiento, la captura de referencias y la exportación estructurada. Todo auxiliar que acceda a la red debe validar la URL de destino antes de realizar una solicitud para reducir el riesgo de falsificación de solicitudes del lado del servidor. Mantenga la verificación de certificados; investigue los fallos de certificados en lugar de desactivar la seguridad del transporte. Guarde las credenciales de API en una ubicación de configuración del usuario o en un entorno inyectado, nunca en las habilidades canónicas, los resultados de ejemplo ni los paquetes generados. Deténgase con un resultado claro de credenciales ausentes en vez de inventar valores. Ejecute los auxiliares mediante el entorno de lenguaje y el gestor de dependencias configurados. Cuando un host en la nube no exponga ese entorno en `PATH`, use la ruta absoluta verificada de su ejecutable. Devuelva resultados legibles por máquinas cuando otro módulo consuma el resultado. Conserve las rutas absolutas de las capturas de pantalla u otros archivos escritos en directorios temporales. ## Prueba las habilidades en cada herramienta de agentes de IA antes de compartirlas Ejecute un análisis de portabilidad sobre todas las habilidades canónicas antes de empaquetarlas. Confirme los metadatos obligatorios, la estructura válida y las funciones conocidas específicas de cada host. Pruebe en cada entorno compatible: - el descubrimiento de instrucciones en la raíz; - la instalación o el enlace de habilidades; - las rutas de activación explícitas y automáticas; - la traducción de nombres de herramientas; - la alternativa en línea cuando no haya agentes delegados disponibles; - la ejecución de auxiliares locales; - el enrutamiento generado y las vías alternativas basadas en documentación. Las advertencias deben identificar la función, el host afectado y la degradación prevista. Un campo opcional ignorado puede seguir siendo compatible; una instrucción obligatoria ausente o una operación básica no disponible no pueden serlo. ## Investiga los errores propios de cada herramienta sin desactivar las protecciones Trate los fallos específicos del host como evidencia del entorno, no como permiso para debilitar las protecciones. - Investigue los fallos de la cadena de certificados o de la resolución de nombres antes de cambiar el código. - Use un ejecutable verificado del entorno virtual cuando la ruta de comandos predeterminada carezca de dependencias. - Consulte los directorios temporales documentados cuando las capturas de pantalla o los informes no estén en el directorio de trabajo. - Use rutas absolutas cuando los artefactos crucen límites de procesos o contenedores. - Sustituya las integraciones remotas no disponibles por auxiliares locales documentados únicamente cuando ofrezcan evidencia equivalente. Registre si una limitación afecta al descubrimiento, la ejecución, la delegación, la red o la ubicación de los artefactos. Mantenga la solución alternativa en el adaptador o en la nota operativa en vez de contaminar la lógica de investigación canónica. ## Termina los cambios probando en herramientas reales y actualizando la documentación Antes de declarar completa una modificación de investigación multiplataforma: - revise la habilidad canónica y todos los adaptadores afectados; - vuelva a compilar el enrutamiento y los paquetes generados; - ejecute el análisis de portabilidad y las pruebas de auxiliares pertinentes; - pruebe hosts representativos en vez de confiar en la inspección de la sintaxis; - actualice el catálogo de capacidades, las instrucciones de instalación y las notas de arquitectura; - confirme que las extensiones opcionales sigan aisladas; - revise los resultados para detectar credenciales, afirmaciones sin respaldo y evidencia ausente. Informe de la capacidad modificada, los hosts verificados, las comprobaciones superadas, las advertencias observadas, las alternativas usadas y las validaciones que no pudieron ejecutarse. No afirme que existe una equivalencia total cuando un host ignore un comportamiento obligatorio o solo se haya probado un entorno.