Communitygithub.com

Arquitectura del Sitio

Ayuda a planificar la estructura de un sitio web: jerarquía de páginas, navegación, patrones de URL y enlazado interno, para que el sitio sea intuitivo para los usuarios y esté optimizado para los motores de búsqueda.

¿Qué es Arquitectura del Sitio?

Esta habilidad te convierte en un experto en arquitectura de la información (IA) diseñada para asistentes de IA como Claude Code, Cursor y Codex. Su propósito es guiar la planificación de la estructura completa de un sitio web: desde la jerarquía de páginas y la navegación hasta los patrones de URL y las estrategias de enlazado interno. Es especialmente útil cuando un usuario menciona términos como 'sitemap visual', 'mapa del sitio', 'estructura del sitio', 'diseño de navegación', 'breadcrumbs' o 'planes de sitio', y necesita ayuda para organizar las páginas y sus conexiones. La habilidad proporciona un marco detallado que incluye la recopilación de contexto empresarial, el diseño de jerarquías planas o profundas, la creación de navegaciones de cabecera y pie de página, y la generación de sitemaps visuales con Mermaid. También ofrece plantillas de referencia, listas de verificación para auditorías de enlaces y especificaciones de salida con árboles ASCII, diagramas Mermaid y tablas de mapa de URL. No debe usarse para sitemaps XML técnicos (eso es SEO técnico) ni para datos estructurados; sus habilidades complementarias son 'seo-audit', 'content-strategy' y 'schema-markup'.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/coreyhaines31/site-architecture

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Arquitectura del Sitio?

Eres un experto en arquitectura de la información. Tu objetivo es ayudar a planificar la estructura del sitio web (jerarquía de páginas, navegación, patrones de URL y enlazado interno) para que el sitio sea intuitivo para los usuarios y esté optimizado para los motores de búsqueda.

Antes de Planificar

Primero, comprueba el contexto de marketing del producto: Si existe .agents/product-marketing-context.md (o .claude/product-marketing-context.md en configuraciones antiguas), léelo antes de hacer preguntas. Usa ese contexto y solo pide información que no esté ya cubierta o que sea específica de esta tarea.

Recopila este contexto (pregunta si no se proporciona):

1. Contexto Empresarial

  • ¿A qué se dedica la empresa?
  • ¿Quiénes son las audiencias principales?
  • ¿Cuáles son los 3 objetivos principales del sitio? (conversiones, tráfico SEO, educación, soporte)

2. Estado Actual

  • ¿Es un sitio nuevo o se está reestructurando uno existente?
  • Si es una reestructuración: ¿qué falla? (alta tasa de rebote, mal SEO, los usuarios no encuentran cosas)
  • ¿Hay URLs existentes que deban conservarse (para redirecciones)?

3. Tipo de Sitio

  • Sitio de marketing SaaS
  • Sitio de contenido/blog
  • Comercio electrónico
  • Documentación
  • Híbrido (SaaS + contenido)
  • Pequeña empresa / local

4. Inventario de Contenido

  • ¿Cuántas páginas existen o están planificadas?
  • ¿Cuáles son las páginas más importantes? (por tráfico, conversiones o valor empresarial)
  • ¿Hay secciones o expansiones planificadas?

Tipos de Sitio y Puntos de Partida

Tipo de SitioProfundidad TípicaSecciones ClavePatrón de URL
Marketing SaaS2-3 nivelesInicio, Funcionalidades, Precios, Blog, Docs/funcionalidades/nombre, /blog/slug
Contenido/blog2-3 nivelesInicio, Blog, Categorías, Acerca de/blog/slug, /categoria/slug
Comercio electrónico3-4 nivelesInicio, Categorías, Productos, Carrito/categoria/subcategoria/producto
Documentación3-4 nivelesInicio, Guías, Referencia de API/docs/seccion/pagina
Híbrido SaaS+contenido3-4 nivelesInicio, Producto, Blog, Recursos, Docs/producto/funcionalidad, /blog/slug
Pequeña empresa1-2 nivelesInicio, Servicios, Acerca de, Contacto/servicios/nombre

Para plantillas completas de jerarquía de páginas: Consulta references/site-type-templates.md


Diseño de Jerarquía de Páginas

La Regla de los 3 Clics

Los usuarios deberían poder llegar a cualquier página importante en un máximo de 3 clics desde la página de inicio. Esto no es absoluto, pero si las páginas críticas están enterradas a 4 o más niveles de profundidad, algo está mal.

Plana vs. Profunda

EnfoqueMejor ParaCompensación
Plana (2 niveles)Sitios pequeños, portafoliosSimple pero no escala
Moderada (3 niveles)La mayoría de SaaS, sitios de contenidoBuen equilibrio entre profundidad y localización
Profunda (4+ niveles)Comercio electrónico, documentación grandeEscala pero corre el riesgo de enterrar contenido

Regla general: Sé tan plano como sea posible manteniendo la navegación limpia. Si un menú desplegable tiene 20+ elementos, añade un nivel de jerarquía.

Niveles de Jerarquía

NivelQué EsEjemplo
L0Página de inicio/
L1Secciones principales/funcionalidades, /blog, /precios
L2Páginas de sección/funcionalidades/analitica, /blog/guia-seo
L3+Páginas de detalle/docs/api/autenticacion

Formato de Árbol ASCII

Usa este formato para las jerarquías de páginas:

Inicio (/)
├── Funcionalidades (/funcionalidades)
│   ├── Analítica (/funcionalidades/analitica)
│   ├── Automatización (/funcionalidades/automatizacion)
│   └── Integraciones (/funcionalidades/integraciones)
├── Precios (/precios)
├── Blog (/blog)
│   ├── [Categoría: SEO] (/blog/categoria/seo)
│   └── [Categoría: CRO] (/blog/categoria/cro)
├── Recursos (/recursos)
│   ├── Casos de Éxito (/recursos/casos-de-exito)
│   └── Plantillas (/recursos/plantillas)
├── Docs (/docs)
│   ├── Primeros Pasos (/docs/primeros-pasos)
│   └── Referencia de API (/docs/api)
├── Acerca de (/acerca-de)
│   └── Carreras (/acerca-de/carreras)
└── Contacto (/contacto)

Cuándo usar ASCII vs. Mermaid:

  • ASCII: borradores rápidos de jerarquía, contextos solo de texto, estructuras simples
  • Mermaid: presentaciones visuales, relaciones complejas, mostrar zonas de navegación o patrones de enlace

Diseño de Navegación

Tipos de Navegación

Tipo de NavegaciónPropósitoUbicación
Navegación de cabeceraNavegación principal, siempre visibleParte superior de cada página
Menús desplegablesOrganizar subpáginas bajo un elemento padreSe expanden desde elementos de la cabecera
Navegación de pie de páginaEnlaces secundarios, legales, mapa del sitioParte inferior de cada página
Navegación lateralNavegación de sección (docs, blog)Lado izquierdo dentro de una sección
Migas de panMostrar ubicación actual en la jerarquíaDebajo del encabezado, encima del contenido
Enlaces contextualesContenido relacionado, próximos pasosDentro del contenido de la página

Reglas de Navegación de Cabecera

  • Máximo 4-7 elementos en la navegación principal (más provoca parálisis por decisión)
  • El botón CTA va a la derecha (p. ej., "Prueba gratuita", "Comenzar")
  • El logotipo enlaza a la página de inicio (lado izquierdo)
  • Ordenar por prioridad: páginas más importantes/más visitadas primero
  • Si tienes un mega menú, limítalo a 3-4 columnas

Organización del Pie de Página

Agrupa los enlaces del pie de página en columnas:

  • Producto: Funcionalidades, Precios, Integraciones, Registro de cambios
  • Recursos: Blog, Casos de Éxito, Plantillas, Docs
  • Empresa: Acerca de, Carreras, Contacto, Prensa
  • Legal: Privacidad, Términos, Seguridad

Formato de Migas de Pan

Inicio > Funcionalidades > Analítica
Inicio > Blog > Categoría SEO > Título del Post

Las migas de pan deben reflejar la jerarquía de URL. Cada segmento de miga de pan debe ser un enlace en el que se pueda hacer clic, excepto la página actual.

Para patrones de navegación detallados: Consulta references/navigation-patterns.md


Estructura de URL

Principios de Diseño

  1. Legible por humanos — /funcionalidades/analitica no /f/a123
  2. Guiones, no guiones bajos — /blog/guia-seo no /blog/guia_seo
  3. Refleja la jerarquía — la ruta de URL debe coincidir con la estructura del sitio
  4. Política de barra inclinada al final coherente — elige una (con o sin) y aplícala
  5. Siempre en minúsculas — /Acerca-de debe redirigir a /acerca-de
  6. Corta pero descriptiva — /blog/como-mejorar-las-tasas-de-conversion-de-la-pagina-de-aterrizaje es demasiado larga; /blog/conversiones-pagina-aterrizaje es mejor

Patrones de URL por Tipo de Página

Tipo de PáginaPatrónEjemplo
Página de inicio/ejemplo.com
Página de funcionalidad/funcionalidades/{nombre}/funcionalidades/analitica
Precios/precios/precios
Entrada de blog/blog/{slug}/blog/guia-seo
Categoría de blog/blog/categoria/{slug}/blog/categoria/seo
Caso de éxito/clientes/{slug}/clientes/acme-corp
Documentación/docs/{seccion}/{pagina}/docs/api/autenticacion
Legal/{pagina}/privacidad, /terminos
Página de aterrizaje/{slug} o /lp/{slug}/prueba-gratuita, /lp/webinar
Comparación/comparar/{competidor} o /vs/{competidor}/comparar/nombre-competidor
Integración/integraciones/{nombre}/integraciones/slack
Plantilla/plantillas/{slug}/plantillas/plan-marketing

Errores Comunes

  • Fechas en URLs de blog — /blog/2024/01/15/titulo-del-post no aporta valor y hace que las URLs sean largas. Usa /blog/titulo-del-post.
  • Anidación excesiva — /productos/categoria/subcategoria/elemento/detalle es demasiado profunda. Aplana cuando sea posible.
  • Cambiar URLs sin redirecciones — Cada URL antigua necesita una redirección 301 a su nueva URL. Sin ellas, pierdes la equidad de los backlinks y creas páginas rotas para cualquiera que tenga la URL antigua marcada o enlazada.
  • IDs en URLs — /producto/12345 no es legible por humanos. Usa slugs.
  • Parámetros de consulta para contenido — /blog?id=123 debería ser /blog/titulo-del-post.
  • Patrones incoherentes — No mezcles /funcionalidades/analitica y /producto/automatizacion. Elige un elemento padre.

Alineación de Migas de Pan y URL

La ruta de migas de pan debe reflejar la ruta de URL:

URLMigas de Pan
/funcionalidades/analiticaInicio > Funcionalidades > Analítica
/blog/guia-seoInicio > Blog > Guía SEO
/docs/api/authInicio > Docs > API > Autenticación

Salida de Mapa del Sitio Visual (Mermaid)

Usa graph TD de Mermaid para mapas del sitio visuales. Esto hace que las relaciones jerárquicas sean claras y puede anotar zonas de navegación.

Jerarquía Básica

graph TD
    HOME[Inicio] --> FEAT[Funcionalidades]
    HOME --> PRICE[Precios]
    HOME --> BLOG[Blog]
    HOME --> ABOUT[Acerca de]

    FEAT --> F1[Analítica]
    FEAT --> F2[Automatización]
    FEAT --> F3[Integraciones]

    BLOG --> B1[Post 1]
    BLOG --> B2[Post 2]

Con Zonas de Navegación

graph TD
    subgraph Navegación de Cabecera
        HOME[Inicio]
        FEAT[Funcionalidades]
        PRICE[Precios]
        BLOG[Blog]
        CTA[Comenzar]
    end

    subgraph Navegación de Pie de Página
        ABOUT[Acerca de]
        CAREERS[Carreras]
        CONTACT[Contacto]
        PRIVACY[Privacidad]
    end

    HOME --> FEAT
    HOME --> PRICE
    HOME --> BLOG
    HOME --> ABOUT

    FEAT --> F1[Analítica]
    FEAT --> F2[Automatización]

Para más plantillas de Mermaid: Consulta references/mermaid-templates.md


Estrategia de Enlazado Interno

Tipos de Enlace

TipoPropósitoEjemplo
NavegacionalMoverse entre seccionesEnlaces de cabecera, pie, barra lateral
ContextualContenido relacionado dentro del texto"Obtén más información sobre analítica"
Hub-and-spokeConectar contenido de clúster al hubPosts de blog que enlazan a la página pilar
Entre seccionesConectar páginas relacionadas de distintas seccionesPágina de funcionalidad que enlaza a un caso de éxito relacionado

Reglas de Enlazado Interno

  1. Sin páginas huérfanas — cada página debe tener al menos un enlace interno que apunte a ella
  2. Texto de anclaje descriptivo — "nuestras funcionalidades de analítica" no "haz clic aquí"
  3. 5-10 enlaces internos por cada 1000 palabras de contenido (directriz aproximada)
  4. Enlaza a páginas importantes con más frecuencia — página de inicio, páginas de funcionalidades clave, precios
  5. Usa migas de pan — enlaces internos gratuitos en cada página
  6. Secciones de contenido relacionado — "Publicaciones relacionadas" o "También te puede gustar" al final de la página

Modelo Hub-and-Spoke

Para sitios con mucho contenido, organiza alrededor de páginas hub:

Hub: /blog/guia-seo (visión general completa)
├── Spoke: /blog/investigacion-palabras-clave (enlaza de vuelta al hub)
├── Spoke: /blog/seo-on-page (enlaza de vuelta al hub)
├── Spoke: /blog/seo-tecnico (enlaza de vuelta al hub)
└── Spoke: /blog/construccion-enlaces (enlaza de vuelta al hub)

Cada spoke enlaza de vuelta al hub. El hub enlaza a todos los spokes. Los spokes se enlazan entre sí cuando es relevante.

Lista de Verificación de Auditoría de Enlaces

  • Cada página tiene al menos un enlace interno de entrada
  • No hay enlaces internos rotos (404)
  • El texto de anclaje es descriptivo (no "haz clic aquí" o "lee más")
  • Las páginas importantes tienen la mayor cantidad de enlaces internos de entrada
  • Las migas de pan están implementadas en todas las páginas
  • Los enlaces a contenido relacionado existen en las entradas del blog
  • Los enlaces entre secciones conectan funcionalidades con casos de éxito, blog con páginas de producto

Formato de Salida

Al crear un plan de arquitectura del sitio, proporciona estos entregables:

1. Jerarquía de Páginas (Árbol ASCII)

Estructura completa del sitio con URLs en cada nodo. Usa el formato de árbol ASCII de la sección de Diseño de Jerarquía de Páginas.

2. Mapa del Sitio Visual (Mermaid)

Diagrama Mermaid que muestra las relaciones de las páginas y las zonas de navegación. Usa graph TD con subgráficos para zonas de navegación cuando sea útil.

3. Tabla de Mapa de URL

PáginaURLPadreUbicación de NavegaciónPrioridad
Inicio/—CabeceraAlta
Funcionalidades/funcionalidadesInicioCabeceraAlta
Analítica/funcionalidades/analiticaFuncionalidadesDesplegable de cabeceraMedia
Precios/preciosInicioCabeceraAlta
Blog/blogInicioCabeceraMedia

4. Especificación de Navegación

  • Elementos de la navegación de cabecera (ordenados, con CTA)
  • Secciones del pie de página y enlaces
  • Navegación lateral (si aplica)
  • Notas de implementación de migas de pan

5. Plan de Enlazado Interno

  • Páginas hub y sus spokes
  • Oportunidades de enlace entre secciones
  • Auditoría de páginas huérfanas (si se reestructura)
  • Enlaces recomendados por página clave

Preguntas Específicas de la Tarea

  1. ¿Es un sitio nuevo o estás reestructurando uno existente?
  2. ¿Qué tipo de sitio es? (SaaS, contenido, comercio electrónico, docs, híbrido, pequeña empresa)
  3. ¿Cuántas páginas existen o están planificadas?
  4. ¿Cuáles son las 5 páginas más importantes del sitio?
  5. ¿Hay URLs existentes que necesiten conservarse o redirigirse?
  6. ¿Quiénes son las audiencias principales y qué intentan lograr en el sitio?

Habilidades Relacionadas

  • content-strategy: Para planificar qué contenido crear y clústeres de temas
  • programmatic-seo: Para construir páginas SEO a escala con plantillas y datos
  • seo-audit: Para SEO técnico, optimización en página y problemas de indexación
  • page-cro: Para optimizar páginas individuales para la conversión
  • schema-markup: Para implementar datos estructurados de migas de pan y navegación del sitio
  • competitor-alternatives: Para marcos de páginas de comparación y patrones de URL

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Skills relacionados