SEO Skill — Optimización de Sitios Estáticos
Herramienta ligera de auditoría y corrección SEO para sitios HTML estáticos (GitHub Pages, Netlify, Vercel, etc.). No requiere herramientas de compilación. Lee tu HTML, informa qué falta y lo añade.
Configuración
Antes del primer uso, dile a Claude información sobre tu sitio para que pueda completar los valores correctos:
- Dominio (p. ej.
https://tunombre.com) - Páginas (p. ej. index, about, resume, projects/foo)
- Perfiles sociales (LinkedIn, GitHub, Twitter, etc.)
- Por qué quieres posicionarte (p. ej. "jane doe software engineer", "jane doe portfolio")
Claude almacena este contexto para la sesión. Solo necesitas decirlo una vez.
Qué hacer al ser invocado
Lee todos los archivos HTML en el directorio fuente del sitio. Verifica cada elemento a continuación. Reporta una tabla de aprobado/fallo y luego ofrece corregir lo que falta.
1. Elementos esenciales del <head> por página
Cada página HTML necesita estos dentro de <head>:
<title>[Título de la Página] — [Tu Nombre]</title>
<meta name="description" content="[único, 150-160 caracteres, incluye palabras clave objetivo]">
<link rel="canonical" href="https://tudominio.com/[ruta]/">
<!-- Open Graph -->
<meta property="og:title" content="[igual que el título o más corto]">
<meta property="og:description" content="[igual que la meta descripción]">
<meta property="og:image" content="https://tudominio.com/[ruta-a-imagen]">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:url" content="https://tudominio.com/[ruta]/">
<meta property="og:type" content="website">
<meta property="og:site_name" content="[Tu Nombre]">
<!-- Twitter Card -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="[igual que og:title]">
<meta name="twitter:description" content="[igual que og:description]">
<meta name="twitter:image" content="https://tudominio.com/[ruta-a-imagen]">
Directrices:
- Título: 50-60 caracteres. Nombre + diferenciador.
- Meta descripción: 150-160 caracteres, única por página, incluye tu nombre + palabras clave relevantes.
- Imagen OG: 1200x630px recomendada. Si no hay imagen personalizada por página, usa una compartida. Utiliza una imagen real del sitio, no un marcador de posición.
- URL canónica: debe coincidir exactamente con la URL desplegada real (consistencia de la barra inclinada final).
2. Datos estructurados (JSON-LD)
Añade el esquema Person + WebSite a la página de inicio:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Person",
"name": "[Tu Nombre]",
"url": "https://tudominio.com",
"jobTitle": "[Tu Título/Rol]",
"affiliation": {
"@type": "Organization",
"name": "[Escuela o Compañía]"
},
"sameAs": [
"[URL de GitHub]",
"[URL de LinkedIn]"
],
"knowsAbout": ["[habilidad1]", "[habilidad2]", "[habilidad3]"]
}
</script>
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "WebSite",
"name": "[Tu Nombre] — [Lema del Portafolio]",
"url": "https://tudominio.com"
}
</script>
Para páginas de proyectos, usa CreativeWork:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "CreativeWork",
"name": "[Nombre del Proyecto]",
"author": { "@type": "Person", "name": "[Tu Nombre]" },
"description": "[Breve descripción del proyecto]",
"url": "https://tudominio.com/[proyecto]/"
}
</script>
Reglas: Solo JSON-LD (no Microdata/RDFa). No FAQPage (restringido a gobierno/salud). No HowTo (obsoleto). Sin texto de marcador de posición en campos de esquema.
3. robots.txt
Crear en la raíz del sitio:
User-agent: *
Allow: /
Sitemap: https://tudominio.com/sitemap.xml
4. sitemap.xml
Crear en la raíz del sitio:
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>https://tudominio.com/</loc>
<lastmod>[AAAA-MM-DD]</lastmod>
<priority>1.0</priority>
</url>
<!-- repetir para cada página -->
</urlset>
Establece lastmod en las fechas de última edición reales. Actualiza el sitemap cuando cambien las páginas.
5. SEO de imágenes
- Todas las etiquetas
<img>necesitan textoaltdescriptivo (no "imagen1" ni "captura de pantalla") - Usa WebP cuando sea posible, mantén las imágenes por debajo de 200KB
- Añade
loading="lazy"a las imágenes que están debajo del pliegue - La imagen OG debe ser un archivo real, no un marcador de posición
6. Señales de contenido y palabras clave
- Etiquetas H1: Una por página, incluye nombre o nombre del proyecto + palabras clave
- Jerarquía de encabezados: h1 > h2 > h3, sin saltar niveles
- Nombre en el texto del cuerpo: Tu nombre debe aparecer de forma natural en cada página
- Enlaces internos: Las páginas deben enlazarse entre sí (página de inicio a proyectos, acerca a proyectos, etc.)
- Enlaces externos: Perfiles sociales enlazados desde la página acerca/inicio
7. Verificaciones técnicas
- HTTPS: Verifica que todos los enlaces y recursos internos utilicen
https:// - Consistencia de barra inclinada final: Elige un patrón y mantenlo en todos los enlaces, canónicos y sitemap
- Sin enlaces rotos: Verifica que todos los atributos
hrefysrcse resuelvan - Responsivo móvil: Etiqueta de meta viewport presente en todas las páginas
- Velocidad de página: Difiere scripts no críticos. JS mínimo = buena base para sitios estáticos.
8. Verificación posterior al despliegue
Después de desplegar:
- Visita
/robots.txty/sitemap.xmldirectamente para verificar que sean accesibles - Prueba las etiquetas OG compartiendo un enlace en Discord/Slack/Twitter y verificando la tarjeta de vista previa
- Envía el sitemap en Google Search Console
- Busca
site:tudominio.comdespués de unos días para verificar la indexación - Busca tus consultas objetivo y rastrea el ranking con el tiempo
9. Configuración de Google Search Console
- Ve a Google Search Console, añade una propiedad para tu dominio
- Verifica mediante un registro TXT de DNS o el método de archivo HTML
- Envía la URL del sitemap
- Monitorea el informe de Cobertura para problemas de indexación
Salida rápida de auditoría
Al ejecutar una auditoría, lee todos los archivos HTML y muestra:
| Verificación | Estado | Notas |
|---|---|---|
| Meta descripciones | ... | ... |
| Etiquetas OG | ... | ... |
| Esquema JSON-LD | ... | ... |
| robots.txt | ... | ... |
| sitemap.xml | ... | ... |
| Texto alt de imágenes | ... | ... |
| Etiquetas H1 | ... | ... |
| Enlaces internos | ... | ... |
| URLs canónicas | ... | ... |
Luego ofrece corregir lo que falta.