🌱 Empieza aquí · Hreflang y SEO internacional

Esta semilla le enseña a tu asistente a revisar y a crear las etiquetas hreflang de un sitio web: las señales que le dicen a Google qué versión de tu página mostrar según el idioma y el país de cada visitante. Con esto, tu asistente detecta los errores que hacen que Google enseñe la página equivocada, y te genera las etiquetas correctas listas para usar.

Para instalarla

Abre esta carpeta con Claude Code o Cowork y dile a tu asistente:

"Siembra esta semilla 🌱"

Con eso basta de tu parte. Tu asistente hace todo lo técnico y al final te dice cómo comprobar que quedó funcionando. Vas a ver algunas palabras en inglés en la pantalla; ni caso, él te guía.

¿Otras formas de pedírselo? "instala esta semilla", "pon a funcionar el revisor de hreflang", "haz el setup de esto". Te entiende igual.

Para el asistente que siembra 🤖

Esto es un skill (habilidad), no un hook (gancho de automatización). No necesita settings.json ni permisos de ejecución: los skills se descubren solos cuando viven en la carpeta correcta. Tu trabajo es copiar los archivos del kernel al lugar adecuado y verificar que quedaron.

1. Decide el alcance con el usuario

Alcance global (recomendado): disponible en todas las conversaciones del usuario. Va en $HOME/.claude/skills/seo-hreflang/.
Alcance de un proyecto: solo dentro de una carpeta específica. Va en <TU-RUTA>/.claude/skills/seo-hreflang/, donde <TU-RUTA> es la carpeta raíz del proyecto del usuario.

Si el usuario no tiene preferencia, usa el alcance global.

2. Copia los archivos del kernel

El kernel trae dos archivos: SKILL.md (el skill) y LICENSE (la licencia MIT del método de origen, que debe viajar con el skill). Copia ambos.

Claude Code / Cowork (macOS o Linux), alcance global:

mkdir -p "$HOME/.claude/skills/seo-hreflang"
cp kernel/SKILL.md "$HOME/.claude/skills/seo-hreflang/SKILL.md"
cp kernel/LICENSE "$HOME/.claude/skills/seo-hreflang/LICENSE"

Windows (PowerShell): misma ruta ~/.claude/skills/seo-hreflang/. Son archivos de texto, así que funcionan igual en cualquier sistema:

New-Item -ItemType Directory -Force "$HOME\.claude\skills\seo-hreflang"
Copy-Item kernel\SKILL.md "$HOME\.claude\skills\seo-hreflang\SKILL.md"
Copy-Item kernel\LICENSE "$HOME\.claude\skills\seo-hreflang\LICENSE"

No hace falta chmod: SKILL.md es un archivo de texto que el asistente lee, no un programa que se ejecute. Esta semilla no tiene placeholders que configurar: funciona tal cual, porque valida contra estándares públicos (ISO 639-1 e ISO 3166-1).

3. Verificación post-siembra (obligatoria)

Paso A · comprueba que el archivo quedó en su lugar y con el nombre correcto:

ls -la "$HOME/.claude/skills/seo-hreflang/SKILL.md" && grep -m1 '^name:' "$HOME/.claude/skills/seo-hreflang/SKILL.md"

Salida esperada (el archivo listado + la línea del nombre), con exit=0:

-rw-r--r--  1 usuario  staff  ...  SKILL.md
name: seo-hreflang

Si sale No such file or directory, la copia no se hizo; repite el paso 2.

Paso B · prueba funcional (el asistente la corre él mismo, sin scripts). Los skills se cargan al inicio de la conversación, así que reinicia la sesión primero. Luego pásale este conjunto de etiquetas de prueba, escrito a propósito con dos códigos mal puestos y sin la etiqueta autorreferencial ni la x-default:

<link rel="alternate" hreflang="eng" href="https://example.com/page" />
<link rel="alternate" hreflang="en-uk" href="https://example.co.uk/page" />

Pídele: "valida este hreflang". El resultado correcto:

Detecta que eng es inválido (es ISO 639-2) y propone en (ISO 639-1).
Detecta que en-uk es inválido (UK no es código de país) y propone en-GB.
Señala que falta la etiqueta autorreferencial y la etiqueta x-default.

Si el asistente identifica esos errores y da las correcciones, el skill está vivo. Avísale al usuario que ya quedó y explícale en una línea qué gana con esto.

✅ ¿Cómo sé que funcionó?

A partir de ahora, cada vez que tengas un sitio con versiones en varios idiomas o países, tu asistente puede revisarlas por ti. Le dices "revisa el hreflang de esta URL" y te dice qué está mal y cómo arreglarlo. Y si aún no tienes esas etiquetas, se las pides y te las genera desde cero, validadas contra los estándares oficiales.

La prueba más fácil: pásale la dirección de tu sitio (o de una página que tenga versiones en otro idioma) y pídele que revise el hreflang. Si te devuelve un informe con los problemas encontrados y las correcciones, el skill está haciendo su trabajo. 🌱

Hreflang y SEO internacional