Communitygithub.com

Site perso : le SEO pour qu'on vous trouve par votre nom

Une skill SEO légère pour Claude Code dédiée aux portfolios statiques et sites personnels : audit en 9 points des balises meta, Open Graph, Twitter cards, JSON-LD, robots.txt, sitemap, images, titres et liens, puis ajout de chaque correction dans votre HTML.

Qu'est-ce que Site perso : le SEO pour qu'on vous trouve par votre nom ?

Recette Site personnel, étape 3 (être trouvé), issue de aevans-eng/seo-skill. Tapez /seo ou demandez simplement pourquoi votre site n'apparaît pas quand on cherche votre nom. L'agent lit votre HTML sur GitHub Pages, Netlify ou Vercel et lance un audit en 9 points : title, description et canonical ; balises Open Graph et Twitter Card ; JSON-LD Person et WebSite sur l'accueil et CreativeWork sur les pages projets ; robots.txt et sitemap.xml ; texte alt, lazy loading et poids des images ; un seul H1 par page, hiérarchie des titres et liens internes ; HTTPS et liens cassés ; étapes Search Console après la mise en ligne. Il affiche un tableau réussi/échoué et propose de tout ajouter, en réutilisant vos images existantes pour les cartes de partage. Sans outil de build ni appel d'API.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Compétence SEO — Optimisation de sites statiques

Outil léger d'audit et de correction SEO pour sites HTML statiques (GitHub Pages, Netlify, Vercel, etc.). Aucun outil de build requis. Il lit votre HTML, signale ce qui manque et l'ajoute.

Configuration

Avant la première utilisation, indiquez à Claude les informations de votre site afin qu'il puisse renseigner les bonnes valeurs :

  • Domaine (ex. https://votrenom.com)
  • Pages (ex. index, about, resume, projects/foo)
  • Profils sociaux (LinkedIn, GitHub, Twitter, etc.)
  • Ce pour quoi vous souhaitez être référencé (ex. « jane doe ingénieure logicielle », « portfolio jane doe »)

Claude conserve ce contexte pour la session. Vous n'avez à le dire qu'une seule fois.


Que faire lors de l'invocation

Lisez tous les fichiers HTML du répertoire source du site. Vérifiez chaque élément ci-dessous. Rapportez un tableau de réussite/échec, puis proposez de corriger ce qui manque.


1. Éléments essentiels <head> par page

Chaque page HTML doit contenir ces éléments dans <head> :

<title>[Titre de la page] — [Votre Nom]</title>
<meta name="description" content="[unique, 150-160 caractères, inclut les mots-clés cibles]">
<link rel="canonical" href="https://votredomaine.com/[chemin]/">

<!-- Open Graph -->
<meta property="og:title" content="[identique au titre ou plus court]">
<meta property="og:description" content="[identique à la meta description]">
<meta property="og:image" content="https://votredomaine.com/[chemin-vers-image]">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:url" content="https://votredomaine.com/[chemin]/">
<meta property="og:type" content="website">
<meta property="og:site_name" content="[Votre Nom]">

<!-- Twitter Card -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="[identique à og:title]">
<meta name="twitter:description" content="[identique à og:description]">
<meta name="twitter:image" content="https://votredomaine.com/[chemin-vers-image]">

Recommandations :

  • Titre : 50-60 caractères. Nom + différenciateur.
  • Meta description : 150-160 caractères, unique par page, incluez votre nom et les mots-clés pertinents.
  • Image OG : 1200x630px recommandé. Si aucune image personnalisée n'existe par page, utilisez une image partagée. Utilisez une image réelle du site, pas un placeholder.
  • URL canonique : doit correspondre exactement à l'URL déployée réelle (cohérence de la barre oblique finale).

2. Données structurées (JSON-LD)

Ajoutez les schémas Personne + SiteWeb sur la page d'accueil :

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Person",
  "name": "[Votre Nom]",
  "url": "https://votredomaine.com",
  "jobTitle": "[Votre Titre/Rôle]",
  "affiliation": {
    "@type": "Organization",
    "name": "[École ou Entreprise]"
  },
  "sameAs": [
    "[URL GitHub]",
    "[URL LinkedIn]"
  ],
  "knowsAbout": ["[compétence1]", "[compétence2]", "[compétence3]"]
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "name": "[Votre Nom] — [Slogan du portfolio]",
  "url": "https://votredomaine.com"
}
</script>

Pour les pages de projet, utilisez CreativeWork :

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "CreativeWork",
  "name": "[Nom du projet]",
  "author": { "@type": "Person", "name": "[Votre Nom]" },
  "description": "[Brève description du projet]",
  "url": "https://votredomaine.com/[projet]/"
}
</script>

Règles : JSON-LD uniquement (pas de Microdata/RDFa). Pas de FAQPage (réservé au gouvernement/santé). Pas de HowTo (obsolète). Pas de texte placeholder dans les champs de schéma.

3. robots.txt

Créez à la racine du site :

User-agent: *
Allow: /

Sitemap: https://votredomaine.com/sitemap.xml

4. sitemap.xml

Créez à la racine du site :

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <url>
    <loc>https://votredomaine.com/</loc>
    <lastmod>[AAAA-MM-JJ]</lastmod>
    <priority>1.0</priority>
  </url>
  <!-- répéter pour chaque page -->
</urlset>

Définissez lastmod avec les dates réelles de dernière modification. Mettez à jour le sitemap lorsque les pages changent.

5. SEO des images

  • Toutes les balises <img> doivent avoir un texte alt descriptif (pas « image1 » ou « capture d'écran »)
  • Utilisez le format WebP si possible, gardez les images sous 200 Ko
  • Ajoutez loading="lazy" aux images situées sous la ligne de flottaison
  • L'image OG doit être un fichier réel, pas un placeholder

6. Signaux de contenu et mots-clés

  • Balises H1 : Une par page, inclut le nom ou le nom du projet + mots-clés
  • Hiérarchie des titres : h1 > h2 > h3, pas de niveaux sautés
  • Nom dans le texte : Votre nom doit apparaître naturellement sur chaque page
  • Liens internes : Les pages doivent se lier entre elles (page d'accueil vers projets, à propos vers projets, etc.)
  • Liens externes : Profils sociaux liés depuis la page à propos/accueil

7. Vérifications techniques

  • HTTPS : Vérifiez que tous les liens internes et ressources utilisent https://
  • Cohérence de la barre oblique : Choisissez un motif et respectez-le pour tous les liens, canoniques et le sitemap
  • Aucun lien cassé : Vérifiez que tous les attributs href et src aboutissent à une ressource valide
  • Adaptatif mobile : La balise meta viewport est présente sur toutes les pages
  • Vitesse de la page : Différez les scripts non critiques. Un JS minimal = bonne base pour les sites statiques.

8. Vérification post-déploiement

Après le déploiement :

  1. Accédez directement à /robots.txt et /sitemap.xml pour vérifier qu'ils sont accessibles
  2. Testez les balises OG en partageant un lien sur Discord/Slack/Twitter et en vérifiant la carte de prévisualisation
  3. Soumettez le sitemap dans Google Search Console
  4. Recherchez site:votredomaine.com après quelques jours pour vérifier l'indexation
  5. Recherchez vos requêtes cibles et suivez le classement au fil du temps

9. Configuration de Google Search Console

  1. Allez dans Google Search Console, ajoutez une propriété pour votre domaine
  2. Vérifiez via un enregistrement DNS TXT ou la méthode de fichier HTML
  3. Soumettez l'URL du sitemap
  4. Surveillez le rapport de couverture pour les problèmes d'indexation

Résultat rapide de l'audit

Lors de l'exécution d'un audit, lisez tous les fichiers HTML et produisez :

VérificationStatutRemarques
Meta descriptions......
Balises OG......
Schéma JSON-LD......
robots.txt......
sitemap.xml......
Texte alt des images......
Balises H1......
Liens internes......
URL canoniques......

Ensuite, proposez de corriger ce qui manque.

Skills associés