Communitygithub.com

Web personal: SEO para que te encuentren por tu nombre

Una skill de SEO ligera para Claude Code pensada para portafolios estáticos y webs personales: auditoría de 9 puntos de meta tags, Open Graph, Twitter cards, JSON-LD, robots.txt, sitemap, imágenes, encabezados y enlaces, y luego añade cada corrección a tu HTML.

¿Qué es Web personal: SEO para que te encuentren por tu nombre?

Receta Web personal, paso 3 (que te encuentren), de aevans-eng/seo-skill. Escribe /seo o pregunta sin más por qué tu web no aparece cuando buscas tu nombre. El agente lee tu HTML en GitHub Pages, Netlify o Vercel y ejecuta una auditoría de 9 puntos: title, description y canonical; etiquetas Open Graph y Twitter Card; JSON-LD Person y WebSite en la portada y CreativeWork en las páginas de proyectos; robots.txt y sitemap.xml; texto alt, carga diferida y peso de las imágenes; un H1 por página, jerarquía de encabezados y enlaces internos; HTTPS y enlaces rotos; y los pasos de Search Console tras publicar. Muestra una tabla de aprobado/suspenso y se ofrece a añadirlo todo, reutilizando tus imágenes para las tarjetas al compartir. Sin herramientas de build ni llamadas a API.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add aevans-eng/seo-skill

Preguntar en tu IA favorita

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

Documentación

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 texto alt descriptivo (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 href y src se 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:

  1. Visita /robots.txt y /sitemap.xml directamente para verificar que sean accesibles
  2. Prueba las etiquetas OG compartiendo un enlace en Discord/Slack/Twitter y verificando la tarjeta de vista previa
  3. Envía el sitemap en Google Search Console
  4. Busca site:tudominio.com después de unos días para verificar la indexación
  5. Busca tus consultas objetivo y rastrea el ranking con el tiempo

9. Configuración de Google Search Console

  1. Ve a Google Search Console, añade una propiedad para tu dominio
  2. Verifica mediante un registro TXT de DNS o el método de archivo HTML
  3. Envía la URL del sitemap
  4. 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ónEstadoNotas
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.

Skills relacionados