site-architecture
por alirezarezvanisite-architecture ayuda a los agentes de IA a auditar y planificar la estructura de sitios web, la jerarquía de URL, la navegación, las rutas de rastreo, los breadcrumbs y el enlazado interno para SEO técnico. Incluye guías de diseño de URL y enlazado interno, además de un script analizador de sitemaps para generar recomendaciones de arquitectura basadas en evidencia.
Esta skill obtiene 84/100, por lo que es una candidata sólida para usuarios del directorio que buscan que un agente audite o rediseñe la arquitectura de información de un sitio web y su enlazado interno. La evidencia del repositorio muestra suficiente claridad en los disparadores, profundidad de flujo de trabajo, material de referencia y un script de análisis utilizable como para ofrecer bastante más valor que un prompt SEO genérico, aunque el empaquetado podría ser más claro para la instalación y la incorporación inicial.
- La superficie de activación en el frontmatter es clara y cubre arquitectura del sitio, estructura de URL, navegación, breadcrumbs, topic clusters, páginas huérfanas y problemas de SEO estructural, con exclusiones para estrategia de contenidos y schema markup.
- La sustancia operativa se apoya en un SKILL.md extenso, prompts para recopilar contexto, 11 secciones H2, 20 secciones H3 y referencias prácticas sobre enlazado interno y diseño de URL.
- Incluye un analizador de sitemaps en Python stdlib que puede inspeccionar archivos sitemap.xml para revisar profundidad, patrones de URL, rutas duplicadas, posibles páginas huérfanas y salida de resumen en JSON.
- La carpeta de la skill no incluye comando de instalación ni README, por lo que los usuarios del directorio quizá deban deducir la instalación a partir de las convenciones del repositorio principal.
- La evidencia disponible muestra una guía sólida para arquitectura SEO, pero algunos extractos del flujo de trabajo están parcialmente truncados; por eso, la confianza sobre todos los detalles de ejecución de principio a fin no es absoluta.
Descripción general de site-architecture skill
Para qué está diseñado site-architecture
El skill site-architecture ayuda a un asistente de IA a auditar, rediseñar o planificar la estructura de un sitio web para SEO técnico, rastreabilidad, navegación, higiene de URLs y enlazado interno. Es especialmente útil cuando el problema es estructural: carpetas de URL desordenadas, páginas hub débiles, páginas huérfanas, navegación poco clara, rutas de rastreo deficientes o una migración de sitio que necesita una arquitectura de información segura para SEO.
Usuarios y proyectos para los que encaja mejor
Este skill site-architecture encaja con consultores SEO, equipos de SEO técnico, responsables de contenido, founders y desarrolladores que necesitan recomendaciones prácticas de arquitectura, no consejos generales de marketing. Es especialmente relevante para SaaS, B2B, sitios de contenido, sitios de documentación, estructuras de categorías de e-commerce, sitios de servicios locales y sitios que se están reorganizando alrededor de clústeres temáticos o modelos hub-and-spoke.
Qué lo hace más potente que un prompt genérico
Un prompt genérico puede decir “mejora el enlazado interno”, pero este skill le da al asistente un flujo de trabajo definido: recopilar el estado actual, los objetivos y las restricciones; evaluar patrones de URL; mapear la profundidad de navegación; y recomendar modelos de enlazado interno. El repositorio también incluye references/internal-linking-playbook.md, references/url-design-guide.md y scripts/sitemap_analyzer.py, por lo que el skill es más operativo que una breve checklist de SEO.
Cuándo este skill no es la opción adecuada
No uses site-architecture como herramienta principal para decidir qué artículos nuevos publicar, redactar textos de página, implementar schema markup o hacer keyword research desde cero. Puede apoyar esos flujos de trabajo aclarando dónde deberían ubicarse las páginas y cómo deberían conectarse, pero su valor principal está en la arquitectura, no en la ideación de contenido ni en los datos estructurados.
Cómo usar site-architecture skill
Instalación de site-architecture y ruta del repositorio
Instálalo desde el repositorio de skills en GitHub con:
npx skills add alirezarezvani/claude-skills --skill site-architecture
El código fuente está en marketing-skill/skills/site-architecture dentro de alirezarezvani/claude-skills. Después de instalarlo, lee primero SKILL.md y luego revisa:
references/internal-linking-playbook.mdreferences/url-design-guide.mdscripts/sitemap_analyzer.py
No hay un README separado ni un archivo de metadatos en esta carpeta del skill, así que las instrucciones principales de uso están en SKILL.md y en las dos guías de referencia.
Datos de entrada que mejoran el uso de site-architecture
Para obtener buenos resultados con site-architecture, dale al asistente algo más que “arregla mi estructura SEO”. El skill funciona mejor con:
- URL del sitio web y CMS o framework
- URL de
sitemap.xmlo sitemap exportado - Número aproximado de páginas por sección
- Modelo de negocio principal: lead gen, SaaS, e-commerce, medios, local, documentación
- Problemas conocidos: páginas huérfanas, páginas duplicadas, páginas de categoría débiles, exceso de URLs rastreables, malos rankings
- Páginas prioritarias que quieres posicionar o proteger
- Restricciones: sin cambios de URL, fecha límite de migración, límites del CMS, capacidad de ingeniería
Un prompt más sólido sería:
Use the
site-architectureskill to audit our B2B SaaS site. Sitemap:https://example.com/sitemap.xml. We have feature pages, solution pages, integrations, docs, and 250 blog posts. Our priority is ranking solution pages without changing existing high-performing blog URLs. Identify structural issues, recommend URL folder rules, navigation changes, hub pages, and internal links. Flag anything that needs redirects or developer work.
Flujo de trabajo recomendado para una auditoría de arquitectura
Empieza con evidencia. Si tienes un sitemap, ejecuta o pide al asistente que use scripts/sitemap_analyzer.py para revisar la profundidad de las URLs, la distribución por secciones, patrones de rutas duplicadas y posibles candidatas a páginas huérfanas. Luego compara los resultados con url-design-guide.md para detectar slugs inconsistentes, carpetas demasiado profundas, rutas de blog basadas en fechas, convenciones mixtas de trailing slash o nombres de secciones poco claros.
Después, usa internal-linking-playbook.md para elegir un patrón de enlazado. Hub-and-spoke suele funcionar mejor para autoridad temática; el enlazado lineal encaja con cursos y documentación; los modelos de categoría a producto son adecuados para e-commerce. Si los recursos son limitados, pide una lista priorizada de correcciones en lugar de un rediseño completo.
Patrón de prompt práctico
Un prompt completo para guiar site-architecture debería incluir el formato de salida deseado. Por ejemplo:
Produce: 1) current architecture diagnosis, 2) URL rule recommendations, 3) proposed navigation model, 4) internal linking plan by page type, 5) redirect/migration risks, 6) 30-day implementation plan, 7) open questions.
Esto reduce los consejos vagos y orienta al asistente hacia decisiones que puedas entregar a equipos de SEO, contenido e ingeniería.
FAQ sobre site-architecture skill
¿site-architecture sirve para trabajo de Technical Seo?
Sí. site-architecture para Technical Seo encaja muy bien cuando la tarea incluye rutas de rastreo, patrones de URL indexables, profundidad del sitio, enlazado interno, breadcrumbs, patrones estructurales duplicados o decisiones de URL seguras para una migración. Es menos adecuado para análisis de logs, depuración de Core Web Vitals o implementación de schema, salvo que esos problemas estén conectados con la arquitectura.
¿Pueden usar este skill las personas principiantes?
Sí, pero las personas principiantes deberían aportar detalles concretos del sitio y pedir explicaciones. El skill incluye referencias prácticas, así que puedes pedir “explain each recommendation and why it matters for crawlability or rankings.” Para una primera revisión, pide un diagnóstico antes de solicitar un rediseño completo.
¿Cómo se compara con un prompt SEO normal?
Un prompt SEO normal suele generar recomendaciones generales como “añade enlaces internos” o “haz las URLs más cortas”. Este skill es más estructurado: separa estado actual, objetivos, restricciones, diseño de URLs, navegación y arquitectura de enlazado. El analizador de sitemap incluido también le da una mejor ruta desde datos brutos del sitemap hasta hallazgos accionables.
¿Cuándo debería evitar instalarlo?
Evita instalar site-architecture si solo necesitas ideas de temas para el blog, reescrituras de metadatos, descripciones de producto o snippets de schema. También evita usarlo como única fuente de verdad para una migración de alto riesgo; úsalo para generar el plan de arquitectura y luego valida redirects, canonicals, analítica y datos de rastreo con tus herramientas SEO.
Cómo mejorar site-architecture skill
Dale al skill evidencia real del sitio
La mejor forma de mejorar la salida de site-architecture es proporcionar un sitemap, la navegación actual, los tipos de página clave y las prioridades de ranking. Si no puedes compartir el dominio, aporta ejemplos anonimizados de URLs por sección. Los ejemplos reales ayudan al asistente a detectar si el problema es la profundidad, la nomenclatura, la duplicación, hubs débiles o enlaces faltantes.
Pide decisiones, no solo observaciones
Una solicitud débil pregunta: “¿Qué opinas de nuestra estructura?” Una solicitud mejor sería:
Recommend the preferred URL structure for features, integrations, solutions, blog, and docs. Keep existing ranking blog URLs unchanged unless there is a clear SEO reason to migrate. Mark each recommendation as keep, change, merge, redirect, or investigate.
Esto obliga al skill a producir orientación de arquitectura lista para implementar.
Vigila los modos de fallo comunes
Los modos de fallo comunes incluyen recomendar cambios de URL sin considerar el riesgo de migración, crear demasiadas páginas hub, aplanar todas las URLs sin tener en cuenta su significado o sugerir enlaces internos que no son útiles en contexto. Pide al asistente que separe las “mejoras rápidas y seguras” de los “cambios de nivel migración” y que explique el tradeoff SEO de cada recomendación estructural.
Itera después de la primera salida
Usa la primera respuesta como un borrador del mapa de arquitectura, no como el plan final. Continúa con datos de rastreo, exportaciones de Search Console, prioridades de analítica, restricciones del CMS o feedback de desarrollo. Luego pide al skill site-architecture que revise el plan y lo convierta en una hoja de ruta por fases: enlaces internos inmediatos, limpieza de navegación, reglas de gobernanza de URLs y reestructuración a más largo plazo.