danya-jamal/seo-geo-optimizer

Auditar e melhorar diretamente páginas HTML ou WordPress para SEO técnico, SEO on-page, descoberta relacionada à acessibilidade, dados estruturados, linking interno e otimização para mecanismos generativos (GEO) ou legibilidade para busca com IA. Use quando o Codex deve implementar melhorias de busca baseadas em evidências, orientação ou integração de metadados, schema/JSON-LD, estrutura de conteúdo semântico e respostas prontas para citação, sem excesso de palavras-chave, fatos fabricados ou garantias de ranqueamento.

O que é seo-geo-optimizer?

O skill SEO e GEO Optimizer foi projetado para desenvolvedores e agentes de IA (como Claude Code, Cursor ou Codex) que precisam auditar e otimizar páginas HTML ou WordPress para mecanismos de busca tradicionais e generativos. Ele combina práticas de SEO técnico, on-page, acessibilidade e dados estruturados com técnicas de otimização para motores generativos (GEO), garantindo que o conteúdo seja legível e citável por IAs. O processo começa com a coleta de evidências do projeto (instruções, templates, plugins, schema existente), seguido por uma auditoria abrangente que cobre indexabilidade, metadados, acessibilidade, performance e schema. A implementação foca em melhorias precisas: títulos únicos, meta descrições, hierarquia de headings, links internos contextuais e dados estruturados (JSON-LD) que refletem fielmente o conteúdo visível. Para WordPress, respeita as restrições de plugins e ACF, evitando duplicação de tags e alterações desnecessárias no banco de dados. Após as mudanças, o skill valida código-fonte, esquemas e layout mobile, e gera um relatório detalhado com ações implementadas, bloqueios e próximos passos. É ideal para ambientes onde a precisão técnica e a ética de otimização são prioritárias, sem promessas de ranqueamento ou fabricação de dados.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/danya-jamal/stayora-theme/tree/main/.agents/skills/seo-geo-optimizer

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Otimizador de SEO e GEO

Melhore a página real e sua descoberta. Trate pontuações como sinais diagnósticos, não como objetivo, e nunca prometa ranqueamentos ou citações de IA.

Estabelecer evidências e escopo

  1. Inspecione instruções do repositório, conteúdo da página, templates, convenções de plugins de SEO, propriedade global de metadados, schema existente, restrições de analytics, comportamento de sitemap/robots e páginas internas relevantes.
  2. Determine o público da página, tarefa principal, intenção de busca, tópico canônico, objetivo de negócio, localidade e ação de conversão a partir das evidências fornecidas.
  3. Se pesquisa de palavras-chave, concorrentes, entidades ou resultados atuais de busca for solicitada ou necessária, use fontes autorizadas atuais e documente a data e a evidência. Não invente volumes, dificuldade, alegações de concorrentes, depoimentos, estatísticas, credenciais ou citações.
  4. Preserve o significado do autor e a voz da marca. Sinalize alegações que precisam de aprovação do assunto.

Auditar antes de alterar

Revise:

  • indexabilidade, sinais de status/canônico, conteúdo duplicado ou fino, links rastreáveis e renderização;
  • título, propriedade da meta descrição, orientação de URL, headings, resposta de abertura, cobertura tópica, mídia e chamadas para ação;
  • landmarks semânticos, texto do link, texto alternativo, rótulos de formulário, comportamento de foco/teclado, contraste e conteúdo oculto de tecnologia assistiva ou rastreadores;
  • riscos de performance que afetam descoberta e experiência do usuário, incluindo mídia superdimensionada, mudança de layout, bloqueio de renderização e scripts desnecessários;
  • JSON-LD existente, schema gerado por plugin, breadcrumbs, entidades de organização/site global e grafos duplicados;
  • oportunidades de links internos baseadas em páginas reais do repositório, não em URLs inventadas.

Separe descobertas acionáveis de itens que não podem ser verificados localmente. Priorize por provável impacto, confiança e esforço.

Implementar melhorias

  • Escreva um título único e preciso e uma meta descrição concisa através do mecanismo de SEO existente do projeto. Não crie tags concorrentes se um plugin as possuir.
  • Use um tópico de página claro, uma hierarquia lógica de headings, rótulos de seção descritivos e um resumo direto no início que responda à intenção central.
  • Melhore a clareza com definições concisas, fatos concretos, etapas verificáveis, tabelas de comparação, FAQs e evidências atribuídas apenas onde realmente ajudem os usuários.
  • Torne os relacionamentos de entidades explícitos: identifique a organização, produto/serviço, público, localização, datas, autoria e fontes quando verificados e relevantes.
  • Adicione links internos contextuais para destinos reais e úteis com texto de âncora descritivo. Evite contagens forçadas de links e alegações órfãs.
  • Melhore o HTML semântico e problemas de acessibilidade que afetam a compreensão e descoberta. Mantenha conteúdo importante em HTML rastreável.
  • Preserve a linguagem natural. Não exagere em palavras-chave, encha conteúdo, crie texto de porta de entrada, oculte texto ou otimize para bots às custas dos usuários.
  • Forneça a rastreadores e sistemas de IA passagens autocontidas e consistentes que possam ser citadas com precisão, mantendo nuances e limitações.

Dados estruturados

  1. Selecione apenas tipos de schema suportados pelo conteúdo visível da página e pelo propósito real da página.
  2. Prefira integração com o plugin de SEO existente ou grafo de schema. Evite entidades WebPage, organização, breadcrumb, artigo, produto ou negócio local duplicadas.
  3. Use URLs canônicas estáveis e referências @id consistentes.
  4. Inclua apenas propriedades verdadeiras visíveis ou suportadas pelo site. Não invente avaliações, análises, preços, disponibilidade, autores, locais ou datas.
  5. Adicione marcação FAQ ou HowTo apenas quando o conteúdo correspondente estiver visível e o tipo for apropriado; não assuma que receberá um resultado rico.
  6. Codifique JSON-LD com segurança. No WordPress, siga hooks/helpers existentes e use codificação JSON segura em vez de strings JSON construídas manualmente.

Restrições do WordPress e ACF

  • Respeite a propriedade de tema/plugin de títulos, canônicos, Open Graph, diretivas de robots e schema.
  • Quando o conteúdo vier de ACF, use apenas campos existentes, a menos que explicitamente autorizado a alterar o modelo de campo.
  • Escape a saída por contexto e não enfraqueça a segurança da página para adicionar metadados.
  • Mantenha alterações globais separadas de alterações específicas de página e identifique seu impacto mais amplo antes de editar.

Verificar e relatar

  1. Execute lint disponível, testes, verificações de renderização, verificações de links, validação de dados estruturados e auditorias de acessibilidade/performance apropriadas ao projeto.
  2. Inspecione a fonte renderizada para garantir uma saída de metadados coerente e canônica, JSON-LD válido, conteúdo rastreável e nenhuma tag duplicada de plugin/tema.
  3. Confirme que o schema corresponde ao conteúdo visível e que cada nova URL interna resolve dentro do site conhecido.
  4. Refaça a verificação do layout e interações móveis após alterações de conteúdo.
  5. Relate as alterações implementadas, orientações que exigem configuração de CMS/plugin, resultados de validação, bloqueios não resolvidos e próximos passos priorizados. Diferencie resultados medidos de estimativas.

Habilidades Relacionadas