site-architecture

Visión general de la skill site-architecture

Qué hace la skill site-architecture

La skill site-architecture te ayuda a planificar o reorganizar la jerarquía de páginas, la navegación, la estructura de URLs y el enlazado interno de un sitio web. Está pensada para trabajo de arquitectura de la información, no para generar sitemaps XML técnicos. Si tu pregunta real es “¿qué páginas debería tener este sitio, cómo deberían conectarse y cómo deberían moverse los usuarios por él?”, esta es la skill adecuada.

Quién debería usar site-architecture

Esta skill de site-architecture encaja mejor para:

• marketers que están planificando un sitio nuevo o una reestructuración importante
• founders que están definiendo el sitio de marketing de un SaaS
• equipos de UI/UX que trabajan en navegación y arquitectura de la información
• equipos de contenido con foco en SEO que necesitan decidir hubs, secciones y relaciones entre páginas
• agencias que necesitan una primera versión rápida de sitemap, mapa de URLs y especificación de navegación

Resulta especialmente útil cuando un sitio ha crecido de forma orgánica y ahora se siente difícil de recorrer, inconsistente o con demasiados niveles de profundidad.

Casos de uso donde mejor encaja

Usa site-architecture cuando necesites:

• convertir una lista preliminar de páginas en un mapa del sitio lógico
• decidir entre una estructura plana o más profunda
• definir la navegación del header, footer y secciones
• crear patrones de URL para secciones como /features, /compare o /integrations
• mejorar el enlazado interno entre páginas hub y páginas de detalle
• generar un sitemap visual en ASCII o Mermaid para revisión

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

Un prompt genérico puede listar páginas. La skill site-architecture es más sólida porque empuja hacia un conjunto de entregables más completo:

• contexto de negocio y audiencia primero
• diseño explícito de la jerarquía
• recomendaciones de navegación
• patrones de estructura de URLs
• guía de enlazado interno
• salidas visuales del sitemap
• plantillas reutilizables para tipos de sitio frecuentes

El repositorio también incluye referencias prácticas para diagramas Mermaid, patrones de navegación y plantillas por tipo de sitio, lo que hace que la salida sea más consistente que empezar desde cero.

Límites de alcance importantes

Esta skill no cubre principalmente:

• archivos XML sitemap
• auditorías SEO completas
• schema markup
• wireframes finales o mockups de UI pulidos

Para site-architecture for UI/UX Design, su mayor utilidad está en la capa estructural: agrupación de páginas, orientación, zonas de navegación y descubribilidad del contenido antes del diseño detallado de interfaces.

Cómo usar la skill site-architecture

Contexto de instalación y patrón de acceso

Instala la skill desde el repositorio con:

npx skills add https://github.com/coreyhaines31/marketingskills --skill site-architecture

En la práctica, los usuarios activan site-architecture cuando piden ayuda con sitemaps, navegación, jerarquía de páginas o planificación de URLs. Funciona mejor en una configuración de agente compatible con Skills, donde el modelo puede leer los archivos de la skill y seguir el flujo de trabajo.

Qué archivos leer primero antes de usar site-architecture

Si quieres evaluar la skill rápidamente, empieza aquí:

1. skills/site-architecture/SKILL.md
2. skills/site-architecture/references/site-type-templates.md
3. skills/site-architecture/references/navigation-patterns.md
4. skills/site-architecture/references/mermaid-templates.md
5. skills/site-architecture/evals/evals.json

Ese orden de lectura te muestra el flujo de trabajo, las salidas más habituales, opciones concretas de navegación, formatos de diagrama y cómo se ve una evaluación “buena”.

El input más importante que necesita la skill

La skill site-architecture mejora mucho cuando aportas:

• a qué se dedica la empresa
• audiencias principales
• objetivos principales del sitio, normalmente 2-3 como máximo
• si se trata de un sitio nuevo o de una reestructuración
• inventario de páginas existente, si lo hay
• problemas concretos como duplicación, profundidad excesiva o baja encontrabilidad
• tipo de sitio, como SaaS, ecommerce, servicios, marketplace o sitio con mucho contenido

Si omites esto, el modelo aún puede proponer una estructura, pero será genérica y podría elegir el patrón de navegación equivocado.

Revisa primero el contexto de product marketing

Hay un comportamiento útil y específico del repo: la skill indica explícitamente al agente que revise .agents/product-marketing-context.md o la versión antigua .claude/product-marketing-context.md antes de hacer preguntas. Esto importa porque muchas decisiones de arquitectura dependen del posicionamiento, las audiencias y la estructura de la oferta.

Si ya tienes documentado el contexto de product marketing, indícale al modelo dónde está. Esto reduce idas y vueltas repetitivas y mejora las decisiones de agrupación de páginas.

Convierte un objetivo difuso en un prompt sólido para site-architecture

Prompt débil:

Help me make a sitemap.

Prompt más sólido:

Use the site-architecture skill to plan a SaaS marketing site for an analytics product aimed at ecommerce teams. Our goals are demo requests, SEO traffic, and partner integrations. We need a homepage, pricing, feature pages, docs, blog, integrations, and competitor comparison pages. Keep top nav to 5-6 primary items. Propose page hierarchy, URL structure, header/footer nav, and internal linking model.

Por qué funciona:

• define la audiencia y el tipo de negocio
• nombra objetivos de conversión y de contenido
• lista los tipos de contenido necesarios
• añade una restricción de navegación
• pide entregables concretos para los que la skill está diseñada

Cómo se ve un buen uso de site-architecture

Pide la salida en este orden:

1. supuestos e inputs faltantes
2. jerarquía propuesta
3. mapa de URLs
4. especificación de navegación
5. recomendaciones de enlazado interno
6. árbol ASCII o diagrama Mermaid
7. tradeoffs o preguntas abiertas

Esto refleja las fortalezas prácticas de la skill. Te ayuda a revisar la estructura antes de entrar a discutir etiquetas o detalles de diseño.

Usa las plantillas de referencia en lugar de empezar en blanco

El atajo más importante para adoptar esta skill es el conjunto de referencias:

• site-type-templates.md ofrece patrones de jerarquía ya preparados
• navigation-patterns.md ayuda a elegir entre header simple, mega menu u otros modelos de navegación
• mermaid-templates.md acelera la creación de sitemaps visuales

Para muchos equipos, el mejor flujo es: elegir la plantilla de sitio más cercana, adaptar las secciones y luego afinar navegación y URLs. Suele ser más rápido y mejor que hacer prompting totalmente libre.

Flujo de trabajo recomendado para un sitio nuevo

Para una implementación nueva:

1. define objetivos de negocio y audiencias
2. elige la plantilla de tipo de sitio más cercana
3. ajusta las secciones principales
4. fija convenciones de URL
5. limita la navegación del header a los elementos prioritarios
6. asigna las páginas de apoyo al footer o a la navegación de sección
7. añade enlazado interno tipo hub-and-spoke donde tenga sentido
8. exporta un árbol ASCII o un diagrama Mermaid para revisión con stakeholders

Esto funciona especialmente bien para SaaS, donde secciones como /features, /customers, /resources, /integrations y /compare suelen necesitar una separación clara.

Flujo de trabajo recomendado para una reestructuración

Para un sitio existente desordenado, dale al modelo:

• navegación actual
• número de páginas o inventario
• secciones duplicadas
• páginas con poco tráfico o ownership poco claro
• quejas de usuarios como “can’t find docs” o “too many dropdowns”

Luego pídele que:

• consolide secciones
• elimine puntos de entrada duplicados
• reduzca profundidad innecesaria
• separe la navegación principal de los elementos utilitarios o del footer
• preserve URLs heredadas de alto valor cuando sea posible

Aquí es donde la skill site-architecture resulta más útil que un prompt genérico de brainstorming, porque enfoca el trabajo como una reorganización, no solo como una lista de páginas.

site-architecture para equipos de UI/UX Design

Para UI/UX Design, usa la skill antes de los wireframes cuando necesites aclarar:

• qué debe ir en la navegación global
• dónde hacen falta páginas de entrada de sección
• cómo deberían reflejar la jerarquía las breadcrumbs
• qué páginas merecen acceso directo frente a acceso indirecto
• cuándo está justificado un mega menu

No sustituye el diseño de interacción, pero da a los equipos de UI/UX una base de IA más defendible antes de diseñar componentes.

Formatos de salida prácticos que conviene pedir

La skill rinde mejor cuando solicitas uno o varios de estos formatos:

• árbol ASCII para revisión rápida
• sitemap Mermaid para documentación
• tabla de mapa de URLs con prioridades
• especificación de navegación de header/footer
• modelo de enlazado interno por sección

Todos estos formatos están respaldados por la evidencia del repositorio, así que estás alineando tu solicitud con lo que la skill ya resuelve bien.

FAQ de la skill site-architecture

¿site-architecture es buena para principiantes?

Sí, siempre que ya conozcas los objetivos del sitio y los tipos principales de contenido. La skill aporta estructura más rápido que inventar la arquitectura de la información desde cero. Los principiantes suelen tener problemas cuando aportan demasiado poco contexto, no porque la skill sea demasiado avanzada.

¿Cuándo debería usar site-architecture en lugar de un prompt normal?

Usa la skill site-architecture cuando la salida tenga que ser operativa: jerarquía, navegación, reglas de URL y estrategia de enlazado. Un prompt normal puede servir para idear páginas, pero esta skill funciona mejor cuando necesitas un artefacto de arquitectura revisable.

¿site-architecture crea XML sitemaps?

No. Esta skill está pensada para arquitectura de la información y planificación de navegación. No es la herramienta adecuada para generar XML sitemaps ni para diagnósticos técnicos de rastreo.

¿site-architecture sirve para sitios existentes y no solo para sitios nuevos?

Sí. Encaja muy bien en reestructuraciones, especialmente cuando un sitio tiene demasiadas páginas, agrupaciones inconsistentes o navegación confusa. Dale el estado actual y los puntos de dolor, no solo el estado futuro deseado.

¿Cómo se compara con hacer IA manualmente?

El trabajo manual de IA sigue teniendo mucho valor, pero esta skill acelera la primera propuesta estructural y aporta plantillas reutilizables. Es especialmente útil para bosquejar opciones, hacer visibles los tradeoffs y generar artefactos para revisión en equipo. Aun así, sigues necesitando criterio humano para temas de política interna, ownership y restricciones de implementación.

¿Es una buena opción para site-architecture for UI/UX Design?

Sí, como herramienta de planificación previa. Ayuda a los equipos de UI/UX Design a definir relaciones entre páginas, profundidad de navegación y lógica de orientación antes de entrar en layouts detallados. Es menos adecuada para decisiones de diseño a nivel de componente.

¿Cuándo site-architecture es la skill equivocada?

Sáltatela si lo que realmente necesitas es:

• auditoría técnica SEO
• planificación de schema
• redacción de contenidos
• wireframing de layouts de página en alta fidelidad
• arquitectura de información de aplicaciones que va mucho más allá de los patrones de sitios de marketing

También encaja mal si no puedes aportar contexto básico del negocio.

Cómo mejorar la skill site-architecture

Define restricciones de negocio más precisas

La forma más rápida de mejorar la salida de site-architecture es indicar restricciones explícitas:

• acción de conversión principal
• segmentos de audiencia prioritarios
• número máximo de elementos en el header
• secciones imprescindibles
• secciones que deben quedar fuera de la navegación principal
• si las landing pages SEO son una prioridad

Sin restricciones, el modelo tiende a incluir demasiadas páginas y a priorizar mal la navegación.

Aporta un inventario de páginas para reestructuraciones

Para sitios existentes, pega un inventario aproximado de páginas o la navegación actual. Incluso una lista desordenada sirve. Esto ayuda a la skill site-architecture a detectar oportunidades de consolidación, estructuras duplicadas y secciones huérfanas que de otro modo pasarían desapercibidas.

Pide tradeoffs, no solo una única respuesta

Un patrón de mejora muy útil es:

Give me a recommended architecture plus one simpler option and one SEO-expansion option.

Esto hace aflorar decisiones reales como:

• navegación simple vs navegación escalable
• menos secciones de primer nivel vs hubs dedicados de landing pages
• jerarquía más plana vs categorización más clara

Eso hace que la skill sea más útil para alinear a los stakeholders.

Fuerza una salida más clara con entregables específicos

Si la primera versión se siente vaga, pide:

• un árbol ASCII completo
• patrones exactos de URL
• etiquetas de navegación con recuento de elementos
• ejemplos de breadcrumbs
• enlaces internos a nivel de sección

Los formatos específicos reducen las recomendaciones vagas y hacen que la guía de site-architecture quede más lista para implementar.

Fallos habituales que conviene vigilar

Presta atención a estos problemas en los primeros borradores:

• demasiados elementos de navegación de primer nivel
• nombres de categorías que se solapan
• hubs de contenido mezclados con páginas de conversión sin una prioridad clara
• profundidad excesiva con poco beneficio para el usuario
• blog/resources/docs agrupados de forma inconsistente
• landing pages SEO añadidas sin un plan de enlazado

Estos son problemas comunes de IA que la skill puede introducir si tu prompt es demasiado amplio o ambiguo.

Mejora las recomendaciones de enlazado interno

No aceptes “add internal links” como suficiente. Pide al modelo que especifique:

• qué páginas hub enlazan a qué páginas de detalle
• qué páginas de detalle enlazan de vuelta a los hubs
• dónde tienen sentido los enlaces cruzados, como de features a integrations o de comparisons a pricing
• qué páginas deberían quedar fuera de un enlazado cruzado intensivo

Esto convierte el uso de site-architecture de algo conceptual en algo accionable.

Usa las referencias del repo para reforzar borradores flojos

Si la salida se siente genérica, indica al modelo que aplique:

• references/navigation-patterns.md para decisiones de navegación
• references/site-type-templates.md para cobertura de secciones
• references/mermaid-templates.md para diagramas más claros

Es una de las formas más sencillas de mejorar la skill site-architecture sin cambiar la skill en sí.

Itera después de la primera pasada de arquitectura

Una buena práctica es hacer una segunda ronda con un prompt como:

Revise this site architecture to reduce header nav to 5 items, move low-priority pages to footer, preserve our existing /blog structure, and create a clearer hub model for integrations and comparison pages.

Ese tipo de revisión dirigida suele ser el punto en el que la skill pasa de útil a realmente aprovechable en producción.

Valida la estructura frente a recorridos reales de usuario

Antes de adoptar la salida, comprueba si estos recorridos clave resultan fluidos:

• visitante nuevo que necesita entender el producto
• usuario comparando opciones que debe llegar a una página de decisión
• visitante SEO que llega desde un artículo y avanza hacia intención de producto
• cliente actual que necesita acceder a docs o soporte
• partner potencial que busca detalles sobre integrations

Si esos recorridos se sienten forzados, la site-architecture necesita otra iteración aunque el sitemap se vea limpio.

Mejora site-architecture acotando la audiencia

Las audiencias demasiado amplias generan arquitecturas confusas. Si la primera salida intenta servir a todo el mundo, separa prioridades:

• buyer vs user
• SMB vs enterprise
• prospect vs customer
• contenido educativo vs contenido de conversión

La skill site-architecture mejora mucho cuando la prioridad de audiencia está clara, porque la navegación y la agrupación de páginas pasan a ser más fáciles de defender.