CommunityEscrita e Ediçãogithub.com

umairmsm/wp-seo

Estágio 5 de uma construção WordPress: títulos e descrições, URLs canônicas, proprietário de esquema e JSON-LD, sitemaps, robots.txt e llms.txt, acesso a crawlers de IA, redirecionamentos (301 vs 302), mapas de URLs legados, Search Console e adição de idiomas um piloto de cada vez com Polylang (hreflang, strings .po/.mo, revisão nativa). Use para "SEO", "schema", "redirect", "old URLs", "translate the site", "add French/Spanish", "hreflang", "canonical".

O que é wp-seo?

Esta skill automatiza o estágio 5 de SEO e internacionalização de um site WordPress multi-idioma, garantindo que mecanismos de busca e assistentes de IA compreendam cada página corretamente e que URLs antigas redirecionem para o lugar certo. Ela configura um único proprietário de esquema (Rank Math por padrão) para evitar conflitos de dados estruturados, valida metadados (título, descrição, canônica, H1) com testes automatizados e implementa redirecionamentos 301/302 conforme regras do projeto. Para novos idiomas, segue uma abordagem piloto: primeiro a fundação (Polylang, hreflang, strings .po/.mo), depois revisão nativa e publicação gradual, garantindo que a versão original nunca seja alterada. A skill também gerencia robots.txt, sitemaps, llms.txt para crawlers de IA, verificação no Search Console e Bing, e inclui verificações rigorosas de paridade antes de grandes mudanças. Totalmente documentada para uso com agentes de IA, ela é ideal para desenvolvedores que precisam implementar SEO técnico e multilíngue em sites WordPress com consistência e rastreabilidade.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/umairmsm/wp-site-kit/tree/HEAD/skills/wp-seo

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Estágio 5: SEO e Idiomas

Objetivo: mecanismos de busca e assistentes de IA entendem cada página. URLs antigas caem no lugar certo. Cada idioma extra é tão correto quanto o original.

Etapas de SEO

  1. Um proprietário por tarefa.
    • O plugin de SEO (Rank Math por padrão) controla títulos, meta, sitemaps e o grafo de esquema principal.
    • O arquivo schema.php do core adiciona os tipos próprios do site a esse grafo.
    • Silencie qualquer plugin de domínio que imprima seu próprio esquema, para que haja apenas um grafo, não dois que discordem.
  2. Cada página em tests/helpers/site.ts passa no npm run test:seo:
    • título entre 10 e 65 caracteres;
    • descrição entre 50 e 160;
    • canônica absoluta;
    • um H1;
    • atributo lang;
    • zero requisições ao Google Fonts. Checklist e regras de escrita: references/seo-checklist.md.
  3. Dados estruturados:
    • Organization (ou LocalBusiness) uma única vez.
    • O tipo de item por página (Service, Product, TouristTrip, Course, …).
    • Breadcrumbs (migalhas de pão).
    • FAQ apenas para perguntas realmente respondidas na página.
    • Nunca um Offer sem um preço.
    • Valide com o Rich Results Test do Google e o validador do Schema.org.
  4. Robots, sitemap, llms.txt:
    • ao vivo permite crawling e lista o sitemap; staging bloqueia tudo (o core faz isso);
    • /llms.txt é servido pelo core;
    • decida de propósito se crawlers de IA podem ler o site; depois verifique se a borda não está bloqueando por padrão (wp-ship > cloudflare-edge.md).
  5. Redirecionamentos: siga o arquivo do projeto docs/reference/REDIRECT_RULES.md. Mapeie cada URL antiga que tenha tráfego ou backlinks para sua página nova mais próxima (301, um salto), e teste cada uma.
  6. Paridade antes de grandes mudanças. Antes de um redesign, migração ou lançamento de idioma, capture título, descrição, canônica e H1 de cada URL. Após cada etapa, compare. Recapture apenas para mudanças intencionais, com o motivo no commit.
  7. Search Console e Bing:
    • verifique ambos;
    • envie o sitemap;
    • monitore a indexação de páginas semanalmente no primeiro mês;
    • Search Console mantém apenas 16 meses de dados, então exporte ou ative a exportação em massa cedo.

Etapas de idioma (cada idioma é um piloto primeiro)

Siga references/multilingual.md. Em resumo:

  1. Regra zero: o idioma original não muda. Suas URLs, títulos, tags canônicas e texto permanecem idênticos (a verificação de paridade comprova).
  2. Piloto: a base do idioma (Polylang, o seletor, hreflang, strings em .po/.mo), depois as páginas-chave e os itens principais. Em seguida, uma revisão de falante nativo no staging, depois publique.
  3. O restante vem em lotes, cada um passando pela mesma revisão.
  4. Um idioma que ainda não foi publicado responde com 302 para o idioma original e não aparece em lugar nenhum: nem em sitemaps, hreflang, menus ou no seletor.

Portão (marque em SITE_STATUS.md)

  • npm run test:seo verde no staging; Rich Results test limpo em uma página de cada tipo
  • Sitemap, robots.txt e llms.txt corretos para o ambiente ao vivo
  • Mapa de redirecionamentos de URLs antigas implementado e testado (ou "n/a")
  • Cada idioma extra: piloto aprovado, revisão nativa feita, pares hreflang completos, canônica por idioma

Bugs que já enviamos, então verifique por eles

  • A canônica da página inicial traduzida apontava para a página inicial original, então o Google descartaria /fr/ dos resultados em francês. A canônica de uma página traduzida é a URL traduzida.
  • JSON-LD em inglês em páginas em francês: o esquema deve seguir o idioma da página, ou ser omitido até que seja traduzido.
  • Um portão que redirecionava um idioma não publicado com 301 para a página inicial. Portões são 302.

Individual skills in this repo

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

umairmsm/wp-build

Stage 3 of a wp-site-kit WordPress build - local DDEV site, the core must-use plugin (modules), the presentation-only child theme with skins, the content model (custom post types, meta, WP_Query, render functions), and the enquiry pipeline that saves leads before forwarding. Use when building or changing features, templates, content types, forms or plugin modules on a wp-site-kit site.

umairmsm/wp-content

Stage 4 of a wp-site-kit WordPress build - real copy and photos. Content truth (facts only from the owner), AI drafts and owner approval, claims audits, banned words and fake proof, legal pages, the photo pipeline (dedupe, real-only, EXIF strip, WebP sizes, alt text, AI image register), and recorded content changes. Use for "write the copy", "add photos", "the owner sent new photos", "check for duplicates", "update prices or text on the live site", "legal pages".

umairmsm/wp-design

Stage 2 of a wp-site-kit WordPress build - design direction, a static HTML/CSS prototype with design tokens, owner sign-off with screenshots, self-hosted fonts, and porting the approved look into a swappable WordPress skin. Use for "design the site", "new look", "redesign", "change colours or fonts", "make a new skin", "port the prototype to WordPress".

umairmsm/wp-kickoff

Stage 1 of a wp-site-kit WordPress build. Use when starting a new WordPress website or taking over or rebuilding an existing one - discovery brief, stack decision, creating the project with bin/wp-site-new, locked decisions, private repo and credentials inventory. Triggers - "new WordPress site", "start a client website", "rebuild this site", "take over this WordPress site".

umairmsm/wp-operate

Stage 8 of a wp-site-kit WordPress build and everything after launch - backups with an off-machine copy, restore drills, the disaster-recovery runbook, credentials inventory, update policy, alerts, and working from more than one machine (bridge file, workstation doctor, encrypted state bundle, rescuing unpushed work). Use for "backup", "restore", "move to a new machine/server", "update plugins", "what if the server dies", "work from the cloud box", "set up a second machine".

umairmsm/wp-ship

Stage 7 of a wp-site-kit WordPress build - staging behind Cloudflare Access, server hardening, safe deploys from a commit (scripts/deploy-safe.sh), database content changes, the launch audit, DNS cutover without breaking a running business, and the first week after launch. Use for "deploy", "set up staging", "go live", "launch", "cutover", "move DNS", "harden the server".

umairmsm/wp-site

Start here for any WordPress website built with wp-site-kit, from an empty folder to a live site. Use when someone says "build a WordPress site", "new website for a client", "where are we on the site", "what is next before launch", or asks to continue a site project. Finds the current stage from SITE_STATUS.md, applies the hard rules, and hands over to the right stage skill.

Habilidades Relacionadas