🌱 Empieza aquí · SEO para Shopify Hydrogen

Esta semilla le enseña a tu asistente a hacer SEO de una tienda en Shopify Hydrogen (el sistema headless de Shopify basado en React). Le da el playbook completo: cómo armar los datos estructurados de producto para ganar estrellas y precio en Google, cómo evitar contenido duplicado por las variantes, cómo generar el sitemap, y cómo dejar la tienda lista para Google Shopping. Cuando le pidas ayuda con el SEO de tu tienda, tu asistente ya sabrá qué hacer.

Glosario en una línea: skill (habilidad) = un instructivo que tu asistente carga y activa solo cuando el tema aparece. Headless = el sitio que ve el cliente va separado de la plataforma que gestiona productos y pagos.

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 demás y al final te dice cómo comprobar que quedó funcionando. Verás 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 SEO de Shopify Hydrogen", "haz el setup de esto". Te entiende igual.

Para el asistente que siembra 🤖

Este componente es un skill (una habilidad de conocimiento): un SKILL.md con un frontmatter que trae name y description. El description es el disparador que hace que el skill se active solo cuando la conversación toca SEO de Shopify Hydrogen. No es un hook (no lleva chmod, no toca settings.json y no ejecuta ningún script): se "siembra" colocando el archivo en la carpeta de skills que tu plataforma carga automáticamente.

1. Copia el skill donde tu plataforma lo cargue

El kernel trae un archivo: kernel/SKILL.md.

Claude Code (macOS / Linux / Windows con Git Bash):

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

Windows (PowerShell):

New-Item -ItemType Directory -Force -Path "$HOME\.claude\skills\seo-shopify" | Out-Null
Copy-Item "kernel\SKILL.md" "$HOME\.claude\skills\seo-shopify\SKILL.md"

Cowork: usa la carpeta de skills de tu proyecto si la soporta (.claude/skills/seo-shopify/SKILL.md). Si no, coloca SKILL.md dentro del proyecto y agrega en el archivo de instrucciones (CLAUDE.md) una línea que apunte a él, por ejemplo: "Para SEO de Shopify Hydrogen, aplica el playbook de seo-shopify/SKILL.md."

2. Aterriza los placeholders (recomendado)

El playbook usa placeholders que conviene reemplazar por los datos reales de esta persona antes de usarlo, o dejar que el asistente los pida cuando haga falta:

• <TU-MARCA> → el nombre de la tienda.
• tu-dominio.com → el dominio real.
• TU-SKU-001 → los SKUs reales.
• <TU-EMAIL-DE-CONTACTO> → el correo de atención a clientes.

Si aún no conoces estos datos, no pasa nada: el skill funciona igual y te los va pidiendo cuando los necesite.

3. Verificación post-siembra (obligatoria)

Como es un skill (texto), la verificación tiene dos partes: que el archivo quedó en su lugar, y que el playbook se aplica de verdad.

a) El archivo quedó colocado (Claude Code):

ls -la "$HOME/.claude/skills/seo-shopify/SKILL.md"; echo "exit=$?"

Salida esperada: una línea que lista el archivo (con su tamaño) y exit=0. Si sale No such file or directory, la copia no se hizo; repite el paso 1.

b) El playbook se aplica (prueba de comportamiento, en una conversación nueva): Abre una sesión nueva y pide algo como: "Genera el Product schema JSON-LD para un producto de mi tienda en Shopify Hydrogen." La conducta correcta es que el asistente produzca un bloque JSON-LD Product con offers de tipo AggregateOffer, priceCurrency, availability y hasMerchantReturnPolicy, y que además te recuerde poner el canonical del producto padre en las variantes. Si en vez de eso improvisa un schema pobre o no menciona el canonical de variantes, el skill no se cargó: revisa que SKILL.md esté en ~/.claude/skills/seo-shopify/.

Cuando ambas partes pasen, avísale a la persona en una línea qué gana con esto.

✅ ¿Cómo sé que funcionó?

De ahora en adelante, cada vez que le pidas a tu asistente algo de SEO de tu tienda en Shopify Hydrogen (el schema de un producto, revisar por qué no salen las estrellas en Google, armar el sitemap, o una auditoría completa) va a responder con el método correcto, no a puro tanteo. Con el schema bien puesto, tus productos quedan elegibles para mostrarse con precio, disponibilidad y estrellas en Google (que aparezcan, y cuándo, lo decide Google: no es inmediato ni garantizado), y el canonical de variantes te quita de encima el contenido duplicado. 🌱