🌱 Empieza aquí · SEO Schema · Datos estructurados Schema.org

Esta semilla le enseña a tu asistente a revisar, validar y escribir el marcado de datos estructurados de una página web (Schema.org en formato JSON-LD). Es la información en clave que buscadores como Google leen para entender tu página y mostrarla con resultados enriquecidos. El asistente detecta el marcado que ya tienes, te dice qué falta o qué está mal, te avisa de los tipos que Google ya retiró, y te genera el código listo para pegar.

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. 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 skill de schema", "haz el setup de esto". Te entiende igual.

Para el asistente que siembra 🤖

Este componente es un skill (habilidad): un archivo SKILL.md que la plataforma descubre solo desde la carpeta de habilidades. No es un hook (gancho de automatización): no lleva chmod, no lleva entrada en settings.json y no ejecuta ningún script. Se "siembra" copiando el kernel a la carpeta de skills.

1. Copia el skill a la carpeta de habilidades

El kernel trae dos archivos:

• kernel/SKILL.md — el skill en sí (el método de detección, validación y generación de Schema.org).
• kernel/LICENSE — el aviso de licencia MIT del proyecto de origen. Viaja junto al skill para conservar el crédito íntegro.

Coloca ambos en una subcarpeta con el nombre del skill dentro de la carpeta de habilidades de tu plataforma:

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

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

Claude Code (Windows · PowerShell):

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

Los skills dentro de ~/.claude/skills/ se descubren solos: la plataforma lee el description del frontmatter y activa la habilidad cuando la conversación lo amerita. No hay que registrar nada más.

Cowork: usa la misma carpeta de habilidades si tu proyecto la soporta (.claude/skills/seo-schema/SKILL.md). El mecanismo es el mismo.

Codex: Codex no descubre skills de la misma forma. Si trabajas ahí, copia el contenido de SKILL.md dentro de tu archivo de instrucciones AGENTS.md (o agrégale un puntero al archivo si lo guardas aparte en el proyecto), para que el método se cargue con el resto de tus instrucciones.

2. No hay placeholders obligatorios

Este skill funciona tal cual, sin configuración. Las plantillas de JSON-LD que incluye ya traen placeholders (por ejemplo [Nombre de la organización], [URL del sitio]) que se rellenan en el momento de generar el marcado para una página concreta, no durante la instalación.

3. Verificación post-siembra (obligatoria)

Como es un skill (texto que la plataforma lee), la verificación tiene dos partes: que el archivo quedó en su lugar, y que la habilidad hace su trabajo de verdad.

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

ls -la "$HOME/.claude/skills/seo-schema/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) La habilidad hace su trabajo (prueba de comportamiento, en una conversación nueva): pídele a tu asistente algo como:

"Genérame el JSON-LD de Schema.org para la página de inicio de un negocio local ficticio."

La conducta correcta es que te devuelva un bloque de JSON-LD válido (empieza con "@context": "https://schema.org" y "@type": ...), con placeholders marcados para que llenes tus datos. Como segunda prueba, pregúntale:

"¿El tipo HowTo todavía genera resultados enriquecidos?"

La respuesta correcta reconoce que HowTo está deprecado (sus resultados enriquecidos se removieron en septiembre de 2023). Si el asistente responde ambas cosas bien, el skill se cargó. Si no, revisa que SKILL.md esté dentro de ~/.claude/skills/seo-schema/.

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, cuando trabajes el SEO de una página, tu asistente sabrá manejar los datos estructurados sin que tú tengas que ser experto en Schema.org. Le pides que revise una URL y te dice qué marcado tiene y qué le falta. Le pides que genere el código y te lo entrega válido y listo para pegar. Y te ahorra un error caro: gastar tiempo en tipos de marcado que Google ya retiró.

No tienes que hacer nada especial en el día a día. Solo pídeselo cuando lo necesites. Eso es todo. 🌱