site-architecture

Panorama general de la skill de arquitectura del sitio

Para qué sirve arquitectura del sitio

La skill de site-architecture te ayuda a diseñar o auditar la base técnica que los motores de búsqueda y los rastreadores de IA realmente pueden descubrir y entender. Se centra en decisiones prácticas de estructura del sitio como robots.txt, sitemaps, meta tags, acceso de rastreo y Core Web Vitals, así que resulta útil cuando la visibilidad depende de algo más que la calidad del contenido.

Usuarios y tareas para los que encaja mejor

Usa la site-architecture skill si estás lanzando un sitio nuevo, corrigiendo problemas de indexación o preparando una propiedad con mucho contenido para SEO Content discovery. Es especialmente útil para desarrolladores, responsables de SEO y editores que necesitan un plan técnico claro en lugar de consejos genéricos de SEO.

Qué la hace diferente

Esta skill no es solo un prompt sobre “SEO”. Hace hincapié en la descubribilidad tanto para buscadores tradicionales como para rastreadores de IA como GPTBot, ClaudeBot y PerplexityBot, además de las vistas previas sociales mediante Open Graph y Twitter Cards. Su valor principal es convertir decisiones de arquitectura en páginas rastreables e indexables, con menos bloqueos ocultos.

Cuándo encaja bien y cuándo no

Encaja muy bien cuando el problema es la estructura global del sitio, el acceso de rastreo o la coherencia de los metadatos. Encaja peor si solo necesitas una meta description puntual, un brief de contenido o feedback de diseño sin ninguna capa técnica de publicación.

Cómo usar la skill de arquitectura del sitio

Instala y abre los archivos correctos

Para site-architecture install, usa la skill en el mismo workspace que el sitio que quieres auditar o configurar, y abre primero SKILL.md. El repo es deliberadamente ligero, así que la guía de mayor valor está en ese archivo. No hay scripts complementarios ni carpetas auxiliares en las que apoyarse, lo que significa que la skill depende de leer con atención las reglas y aplicarlas a tu propia stack.

Qué debes introducir en la skill

El patrón de uso de site-architecture usage funciona mejor cuando aportas el tipo de sitio, la plataforma y la restricción actual. Un buen input sería: “Audita nuestro sitio de marketing en Next.js para evaluar rastreabilidad, cobertura de sitemap y acceso de bots de IA; queremos indexación solo para las páginas públicas”. Eso le da a la skill suficiente contexto para producir recomendaciones técnicas útiles en lugar de buenas prácticas demasiado amplias.

Cómo pedir mejores resultados

Usa site-architecture guide como un flujo de trabajo, no como una lista de verificación. Pide uno de estos resultados:

• un borrador de robots.txt para un entorno específico
• una estrategia de sitemap para URLs públicas frente a privadas
• reglas de metadatos para plantillas y tipos de página
• una revisión de rastreo e indexación para la estructura actual del sitio

Si necesitas site-architecture for SEO Content, indica qué páginas de contenido importan más, cómo se generan y qué páginas deben quedar fuera de la búsqueda. Eso ayuda a la skill a equilibrar visibilidad y exclusión, que es el verdadero tradeoff arquitectónico.

Archivos que debes leer primero

Empieza por:

• skills/site-architecture/SKILL.md

Después inspecciona en tu propio repo cualquier ruta referenciada que coincida con:

• robots.txt
• sitemap.xml o generadores de sitemap
• plantillas HTML
• directorios de assets públicos

Como el repo de la skill no tiene archivos extra de soporte, la calidad de la implementación depende de trasladar sus reglas a la estructura real del sitio.

Preguntas frecuentes sobre la skill de arquitectura del sitio

¿La arquitectura del sitio es solo para desarrolladores?

No. La site-architecture skill también es útil para SEOs, equipos de contenido y propietarios de sitios, aunque normalmente son los desarrolladores quienes implementan los cambios finales. Quienes no programan obtienen valor al definir la política de rastreo e indexación antes de que haya cambios de código.

¿En qué se diferencia de un prompt normal?

Un prompt normal suele pedir “mejores prácticas de SEO” y devuelve resultados genéricos. site-architecture es más específico: se centra en acceso de rastreo, descubrimiento, metadatos y restricciones técnicas. Eso la hace mejor cuando necesitas decisiones que afecten a la indexación, no solo sugerencias de redacción.

¿Es apta para principiantes?

Sí, si puedes describir tu sitio con claridad. La skill es apta para principiantes en el sentido de que estructura un problema técnico, pero aun así necesitas datos básicos como tu plataforma, las reglas de URLs públicas y privadas, y si el sitio debe indexarse.

¿Cuándo no debería usarla?

No uses site-architecture cuando la tarea sea puramente creativa, como redactar el texto de la home o poner nombre a un producto. Tampoco es la herramienta adecuada si el sitio no tiene ninguna preocupación de rastreo o indexación, porque la guía de arquitectura sería una carga innecesaria.

Cómo mejorar la skill de arquitectura del sitio

Aporta las restricciones que de verdad importan

Los mejores resultados salen de inputs que indiquen la plataforma, el modelo de hosting y los objetivos de indexación. Di si trabajas con static hosting, SSR, publicación gestionada por CMS o una configuración híbrida, y si alguna sección debe bloquearse para los crawlers. Eso reduce las suposiciones y hace que las recomendaciones se puedan implementar.

Comparte tipos de página, no solo la home

Para mejorar los resultados de site-architecture, enumera las principales clases de URL: páginas de producto, entradas de blog, páginas de categorías, documentación, páginas de inicio de sesión, áreas de administración y páginas de búsqueda filtrada. Así la skill puede separar plantillas indexables de las URLs que deben permanecer excluidas, que muchas veces es la diferencia entre una arquitectura limpia y un desperdicio accidental de rastreo.

Vigila los fallos más comunes

Los errores más habituales son bloquear páginas útiles en robots.txt, exponer URLs duplicadas o de poco valor y publicar metadatos de forma inconsistente entre plantillas. Si la primera respuesta te parece genérica, normalmente el problema es una entrada débil: faltan ejemplos de URLs, no están claras las prioridades de contenido o no se mencionan las limitaciones de la stack técnica.

Itera con evidencias

Después de la primera pasada, contrasta las recomendaciones con archivos y logs reales: confirma la cobertura del sitemap, revisa robots.txt y comprueba los metadatos renderizados en varias páginas representativas. Luego pide a la skill que refine solo las partes que fallan, por ejemplo: “ajústalo para URLs facetadas” o “endurece el acceso de bots en staging frente a producción”. Eso mantiene enfocada la site-architecture skill y produce mejores decisiones técnicas en la segunda pasada.