site-architecture
por alirezarezvanisite-architecture ajuda agentes de IA a auditar e planejar estrutura de sites, hierarquia de URLs, navegação, caminhos de rastreamento, breadcrumbs e links internos para Technical SEO. Inclui guias de desenho de URL e links internos, além de um script analisador de sitemap para recomendações de arquitetura baseadas em evidências.
Esta skill recebe 84/100, o que a torna uma candidata consistente para usuários do diretório que querem um agente para auditar ou redesenhar a arquitetura da informação de um site e seus links internos. As evidências do repositório mostram boa clareza de acionamento, profundidade de workflow, material de referência e um script de análise utilizável, oferecendo bem mais apoio prático do que um prompt genérico de SEO, embora o empacotamento pudesse ser mais claro para instalação e onboarding.
- A superfície de acionamento no frontmatter é clara e cobre arquitetura do site, estrutura de URL, navegação, breadcrumbs, topic clusters, páginas órfãs e problemas estruturais de SEO, com exclusões para estratégia de conteúdo e schema markup.
- A substância operacional é sustentada por um SKILL.md extenso, prompts de coleta de contexto, 11 seções H2, 20 seções H3 e referências práticas para links internos e desenho de URL.
- Inclui um analisador de sitemap em Python stdlib capaz de inspecionar arquivos sitemap.xml em busca de profundidade, padrões de URL, caminhos duplicados, candidatos a órfãos e saída de resumo em JSON.
- Não há comando de instalação nem README na pasta da skill, então usuários do diretório talvez precisem deduzir a instalação pelas convenções do repositório principal.
- As evidências disponíveis indicam uma orientação sólida para arquitetura de SEO, mas os trechos de workflow estão parcialmente truncados; por isso, a confiança na execução completa de ponta a ponta não é absoluta.
Visão geral da skill site-architecture
Para que a site-architecture foi criada
A skill site-architecture ajuda um assistente de IA a auditar, redesenhar ou planejar a estrutura de um site com foco em SEO técnico, rastreabilidade, navegação, higiene de URLs e links internos. Ela é mais útil quando o problema é estrutural: pastas de URL bagunçadas, páginas hub fracas, páginas órfãs, navegação pouco clara, caminhos de rastreamento ruins ou uma migração de site que precisa de uma arquitetura da informação segura para SEO.
Usuários e projetos mais indicados
A skill site-architecture é indicada para consultores de SEO, equipes de SEO técnico, lideranças de conteúdo, founders e desenvolvedores que precisam de recomendações práticas de arquitetura, e não de conselhos genéricos de marketing. Ela é especialmente relevante para SaaS, B2B, sites de conteúdo, sites de documentação, estruturas de categorias de e-commerce, sites de serviços locais e sites que estão se reorganizando em torno de clusters temáticos ou modelos hub-and-spoke.
O que a torna mais forte que um prompt genérico
Um prompt genérico pode dizer “melhore os links internos”, mas esta skill dá ao assistente um fluxo de trabalho definido: levantar o estado atual, os objetivos e as restrições; avaliar padrões de URL; mapear a profundidade da navegação; e recomendar modelos de links internos. O repositório também inclui references/internal-linking-playbook.md, references/url-design-guide.md e scripts/sitemap_analyzer.py, então a skill é mais operacional do que um checklist curto de SEO.
Quando esta skill não é a escolha certa
Não use site-architecture como ferramenta principal para decidir quais novos artigos publicar, escrever copy de páginas, implementar marcação schema ou fazer pesquisa de palavras-chave do zero. Ela pode apoiar esses fluxos ao esclarecer onde as páginas devem ficar e como devem se conectar, mas seu valor central está na arquitetura, não na ideação de conteúdo nem em dados estruturados.
Como usar a skill site-architecture
Instalação da site-architecture e caminho do repositório
Instale a partir do repositório de skills no GitHub com:
npx skills add alirezarezvani/claude-skills --skill site-architecture
O código-fonte fica em marketing-skill/skills/site-architecture dentro de alirezarezvani/claude-skills. Depois da instalação, leia primeiro SKILL.md e, em seguida, inspecione:
references/internal-linking-playbook.mdreferences/url-design-guide.mdscripts/sitemap_analyzer.py
Não há um README separado nem arquivo de metadados nessa pasta da skill, portanto as principais instruções de uso estão em SKILL.md e nos dois guias de referência.
Informações que melhoram o uso da site-architecture
Para usar bem a site-architecture, dê ao assistente mais contexto do que “corrija minha estrutura de SEO”. A skill funciona melhor com:
- URL do site e CMS ou framework
- URL do
sitemap.xmlou sitemap exportado - Número aproximado de páginas por seção
- Modelo principal de negócio: geração de leads, SaaS, e-commerce, mídia, local, documentação
- Problemas conhecidos: páginas órfãs, páginas duplicadas, categorias rasas, excesso de URLs rastreáveis, rankings fracos
- Páginas prioritárias que você quer ranquear ou proteger
- Restrições: sem alterações de URL, prazo de migração, limitações do CMS, capacidade de engenharia
Um prompt mais forte seria:
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.
Fluxo de trabalho sugerido para uma auditoria de arquitetura
Comece pelas evidências. Se você tiver um sitemap, execute ou peça ao assistente para usar scripts/sitemap_analyzer.py para analisar profundidade de URL, distribuição por seções, padrões de caminhos duplicados e possíveis candidatas a páginas órfãs. Depois, compare os resultados com url-design-guide.md para encontrar slugs inconsistentes, pastas profundas demais, caminhos de blog baseados em data, convenções misturadas de barra final ou nomes de seções pouco claros.
Em seguida, use internal-linking-playbook.md para escolher um padrão de links. Hub-and-spoke costuma ser melhor para autoridade temática; links lineares funcionam bem para cursos e documentação; modelos de categoria para produto combinam com e-commerce. Se os recursos forem limitados, peça uma lista priorizada de correções em vez de um redesenho completo.
Modelo prático de prompt
Um prompt completo para orientar a site-architecture deve incluir o formato de saída desejado. Por exemplo:
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.
Isso reduz recomendações vagas e direciona o assistente a tomar decisões que você possa repassar para as equipes de SEO, conteúdo e engenharia.
FAQ da skill site-architecture
A site-architecture serve para trabalho de SEO técnico?
Sim. site-architecture para SEO técnico é uma boa escolha quando a tarefa envolve caminhos de rastreamento, padrões de URLs indexáveis, profundidade do site, links internos, breadcrumbs, padrões estruturais duplicados ou decisões de URL seguras para migração. Ela é menos indicada para análise de arquivos de log, depuração de Core Web Vitals ou implementação de schema, a menos que esses problemas estejam conectados à arquitetura.
Iniciantes podem usar esta skill?
Sim, mas iniciantes devem fornecer detalhes concretos do site e pedir explicações. A skill inclui referências práticas, então você pode solicitar: “explique cada recomendação e por que ela importa para rastreabilidade ou rankings.” Para uma primeira rodada, peça um diagnóstico antes de solicitar um redesenho completo.
Como ela se compara a um prompt normal de SEO?
Um prompt normal de SEO costuma gerar recomendações amplas, como “adicione links internos” ou “deixe as URLs mais curtas”. Esta skill é mais estruturada: ela separa estado atual, objetivos, restrições, desenho de URLs, navegação e arquitetura de links. O analisador de sitemap incluído também cria um caminho melhor entre dados brutos do sitemap e descobertas acionáveis.
Quando devo evitar instalá-la?
Evite instalar site-architecture se você precisa apenas de ideias de temas para blog, reescrita de metadados, descrições de produtos ou snippets de schema. Também evite usá-la como única fonte de verdade para uma migração de alto risco; use-a para gerar o plano de arquitetura e depois valide redirects, canonicals, analytics e dados de rastreamento com suas ferramentas de SEO.
Como melhorar a skill site-architecture
Forneça evidências reais do site para a skill
A melhor forma de melhorar a saída de site-architecture é fornecer um sitemap, a navegação atual, os principais tipos de página e as prioridades de ranking. Se você não puder compartilhar o domínio, envie exemplos anonimizados de URLs por seção. Exemplos reais ajudam o assistente a detectar se o problema é profundidade, nomenclatura, duplicação, hubs fracos ou links ausentes.
Peça decisões, não apenas observações
Uma solicitação fraca seria: “O que você acha da nossa estrutura?” Uma solicitação melhor seria:
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.
Isso força a skill a produzir orientações de arquitetura prontas para implementação.
Fique atento aos modos de falha comuns
Modos de falha comuns incluem recomendar mudanças de URL sem considerar risco de migração, criar páginas hub em excesso, achatar todas as URLs independentemente do significado ou sugerir links internos que não são contextualmente úteis. Peça ao assistente para separar “ganhos rápidos e seguros” de “mudanças em nível de migração” e para explicar o trade-off de SEO de cada recomendação estrutural.
Itere depois da primeira saída
Use a primeira resposta como um rascunho do mapa de arquitetura, não como o plano final. Faça follow-up com dados de crawl, exportações do Search Console, prioridades de analytics, restrições do CMS ou feedback de desenvolvedores. Depois, peça à skill site-architecture para revisar o plano e transformá-lo em um roadmap por fases: links internos imediatos, limpeza da navegação, regras de governança de URLs e reestruturação de longo prazo.