CommunityRedacción y edicióngithub.com

umairmsm/wp-seo

Etapa 5 de una construcción de sitio WordPress: títulos y descripciones, URLs canónicas, un propietario de esquema y JSON-LD, sitemaps, robots.txt y llms.txt, control de acceso para rastreadores de IA, redirecciones (301 vs 302), mapas de URLs heredadas, Search Console y añadir idiomas uno por uno como piloto con Polylang (hreflang, cadenas .po/.mo, revisión nativa). Útil para "SEO", "esquema", "redirección", "URLs antiguas", "traducir el sitio", "añadir francés/español", "hreflang", "canónica".

¿Qué es wp-seo?

Este skill define el flujo de trabajo para la etapa 5 de una construcción de sitio WordPress, centrada en SEO avanzado y gestión de múltiples idiomas. Garantiza que los motores de búsqueda y los asistentes de IA comprendan correctamente cada página, que las URLs antiguas redirijan al lugar correcto y que cada idioma adicional sea tan correcto como el original. Soporta plataformas como WordPress, Polylang y Rank Math (o plugins SEO equivalentes). Organiza el proceso en pasos SEO (propietario único de esquema, validación de títulos/descripciones, datos estructurados, robots.txt, sitemaps, redirecciones, paridad antes de cambios grandes y verificación en Search Console/Bing) y pasos de idioma (regla cero de no cambiar el idioma original, piloto por idioma con revisión nativa, despliegue por lotes y redirecciones 302 para idiomas no publicados). Incluye una puerta de verificación en SITE_STATUS.md y una lista de errores conocidos para evitar.

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

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

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

Documentación

Etapa 5: SEO e idiomas

Objetivo: los motores de búsqueda y los asistentes de IA entienden cada página. Las URLs antiguas llegan al lugar correcto. Cada idioma adicional es tan correcto como el original.

Pasos de SEO

  1. Un propietario por trabajo.
    • El plugin SEO (Rank Math por defecto) es dueño de títulos, meta, sitemaps y el gráfico de esquema principal.
    • El schema.php del núcleo añade los tipos propios del sitio a ese gráfico.
    • Silencia cualquier plugin de dominio que imprima su propio esquema, para que haya un solo gráfico, no dos que discrepen.
  2. Cada página en tests/helpers/site.ts pasa npm run test:seo:
    • título de 10 a 65 caracteres;
    • descripción de 50 a 160;
    • canónico absoluto;
    • un H1;
    • atributo lang;
    • cero solicitudes a Google Fonts. Lista de verificación y reglas de redacción: references/seo-checklist.md.
  3. Datos estructurados:
    • Organización (o LocalBusiness) una vez.
    • El tipo de elemento por página (Service, Product, TouristTrip, Course, …).
    • Breadcrumbs.
    • FAQ solo para preguntas realmente respondidas en la página.
    • Nunca un Offer sin precio.
    • Validar con la prueba de Resultados Enriquecidos de Google y el validador de Schema.org.
  4. Robots, sitemap, llms.txt:
    • El entorno real permite el rastreo y lista el sitemap; el de staging bloquea todo (el núcleo hace esto);
    • /llms.txt es servido por el núcleo;
    • Decide a propósito si los rastreadores de IA pueden leer el sitio, luego verifica que el edge no los esté bloqueando por defecto (wp-ship > cloudflare-edge.md).
  5. Redirecciones: sigue las docs/reference/REDIRECT_RULES.md del proyecto. Mapea cada URL antigua que tenga tráfico o backlinks a su página nueva más cercana (301, un salto), y prueba cada una.
  6. Paridad antes de cambios grandes. Antes de un rediseño, migración o lanzamiento de idioma, captura título, descripción, canónico y H1 para cada URL. Después de cada paso, compara. Vuelve a capturar solo para cambios intencionados, con el motivo en el commit.
  7. Search Console y Bing:
    • verifica ambos;
    • envía el sitemap;
    • supervisa la indexación de páginas semanalmente durante el primer mes;
    • Search Console retiene solo 16 meses de datos, así que exporta o activa la exportación masiva temprano.

Pasos de idioma (cada idioma es un piloto primero)

Sigue references/multilingual.md. En resumen:

  1. Regla cero: el idioma original no cambia. Sus URLs, títulos, etiquetas canónicas y texto se mantienen idénticos (la verificación de paridad lo demuestra).
  2. Piloto: la base del idioma (Polylang, el conmutador, hreflang, cadenas en .po/.mo), luego las páginas clave y los elementos principales. Luego una revisión de hablante nativo en staging, luego publicar.
  3. El resto llega en lotes, cada uno con la misma revisión.
  4. Un idioma que aún no se ha publicado responde 302 al idioma original y no aparece en ningún lugar: ni en sitemaps, hreflang, menús ni en el conmutador.

Puerta (marcar en SITE_STATUS.md)

  • npm run test:seo en verde en staging; prueba de Resultados Enriquecidos limpia en una página de cada tipo
  • Sitemap, robots.txt y llms.txt correctos para el entorno real
  • Mapa de redirección de URLs antiguas implementado y probado (o "n/a")
  • Cada idioma adicional: piloto superado, revisión nativa realizada, pares hreflang completos, canónico por idioma

Errores que enviamos una vez, así que revísalos

  • La canónica de la página de inicio traducida apuntaba a la página de inicio original, por lo que Google eliminaba /fr/ de los resultados en francés. La canónica de una página traducida es la URL traducida.
  • JSON-LD en inglés en páginas francesas: el esquema debe seguir el idioma de la página, o dejarse fuera hasta que se traduzca.
  • Una puerta que redirigía con 301 un idioma no publicado a la página de inicio. Las puertas son 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.

Skills relacionados