seo-audit

Présentation de la skill seo-audit

Ce que fait la skill seo-audit

La skill seo-audit aide un agent à mener un audit SEO structuré, au lieu de passer directement à des conseils génériques. Elle est conçue pour diagnostiquer pourquoi un site sous-performe en recherche organique, quoi inspecter en priorité, et comment transformer les constats en plan d’action priorisé.

À qui s’adresse cette skill seo-audit

Cas d’usage idéaux :

• les marketers et fondateurs qui veulent un workflow de diagnostic SEO reproductible
• les agents qui auditent des sites SaaS, de contenu ou d’entreprise
• les équipes confrontées à une baisse de trafic, des problèmes d’indexation, un manque de visibilité, ou des soucis on-page mal définis
• toute personne qui veut un seo-audit guide plus solide qu’un simple prompt ponctuel

Moins adapté si :

• vous cherchez uniquement des détails d’implémentation de schema markup
• vous faites de la génération de pages SEO à grande échelle
• vous êtes surtout focalisé sur l’optimisation pour la recherche IA plutôt que sur un audit SEO classique

Le vrai besoin auquel elle répond

La plupart des personnes qui demandent un audit SEO ne veulent pas seulement une checklist. Elles veulent savoir :

• ce qui bloque probablement le ranking
• quelles preuves recueillir en premier
• ce qu’il ne faut pas affirmer sans accès adéquat
• quels problèmes comptent vraiment maintenant

Cette skill est utile parce qu’elle impose un ordre d’audit : d’abord l’exploration et l’indexation, puis les fondamentaux techniques, l’optimisation on-page, la qualité du contenu, et enfin l’autorité ou les liens. Cette séquence évite que des recommandations à faible impact masquent des problèmes bien plus sérieux de santé du site.

Ce qui distingue cette skill d’un prompt générique

Ses différences concrètes :

• elle demande à l’agent de vérifier d’abord le contexte product marketing si un fichier de contexte local existe
• elle demande le contexte manquant sur l’entreprise et le site avant d’auditer à l’aveugle
• elle applique un ordre clair de priorité pour les constats
• elle signale explicitement une limite sur la détection du schema markup lorsqu’on se base uniquement sur le HTML récupéré
• elle attend une structure de rapport avec résumé exécutif et actions priorisées

Ces détails comptent, car beaucoup d’audits SEO faibles donnent une impression d’assurance tout en passant à côté des bases de l’indexation ou en surestimant ce qu’on peut vraiment vérifier avec un accès limité.

Comment utiliser la skill seo-audit

Contexte d’installation de seo-audit

Installez-la depuis le repo avec :

npx skills add https://github.com/coreyhaines31/marketingskills --skill seo-audit

Cela ajoute la skill depuis skills/seo-audit dans le dépôt coreyhaines31/marketingskills. Il n’existe pas d’installateur séparé à l’intérieur de la skill elle-même ; en pratique, l’étape seo-audit install correspond donc à la commande Skills standard ci-dessus.

Fichiers à lire avant la première utilisation

Pour un parcours de lecture rapide et utile dans le repo, ouvrez :

1. skills/seo-audit/SKILL.md
2. skills/seo-audit/evals/evals.json
3. skills/seo-audit/references/ai-writing-detection.md

Pourquoi dans cet ordre :

• SKILL.md présente le workflow et le périmètre de l’audit
• evals/evals.json montre à quoi ressemble une bonne exécution
• la référence sur l’écriture aide à rendre le rendu d’audit plus lisible et moins artificiel, ce qui compte si vous partagez les conclusions à des clients ou des parties prenantes

Les entrées dont la skill a besoin

La qualité du seo-audit usage dépend fortement des éléments que vous fournissez. Au minimum, donnez :

• l’URL du site
• le type de site : SaaS, e-commerce, média, entreprise locale, marketplace, etc.
• l’objectif SEO : plus de leads, plus de trafic hors marque, reprise après une baisse, meilleur positionnement de pages clés
• les mots-clés cibles ou clusters thématiques
• les problèmes connus : migration, refonte, changement de CMS, perte de trafic, plaintes liées à l’indexation
• le périmètre : site complet, section, template, ou page unique
• le niveau d’accès : web public uniquement, données Search Console, analytics, exports de crawl, URLs de concurrents

Si vous omettez ces informations, la skill reste exploitable, mais la sortie penchera davantage vers des vérifications on-page visibles et des heuristiques techniques assez larges.

Vérifiez le contexte local avant de poser des questions

L’un des aspects les plus utiles — et pourtant facile à manquer — de cette skill seo-audit est l’instruction de lire .agents/product-marketing-context.md ou .claude/product-marketing-context.md en premier si le fichier existe. Si vous utilisez la skill dans le repo d’un projet, cela peut supprimer de nombreux allers-retours basiques sur l’audience, le positionnement et les pages prioritaires.

Cela améliore la qualité de l’audit, car les recommandations SEO sont bien meilleures lorsqu’elles sont reliées au produit réel, au funnel et au marché.

Transformer une demande vague en bon prompt d’audit

Entrée faible :

• "Do an SEO audit of our site"

Entrée plus solide :

• "Run an SEO audit for https://example.com. We are a B2B SaaS company selling payroll software for remote teams. Primary goal is demo signups from non-brand organic search. Priority keywords are global payroll software, employer of record payroll, and multi-country payroll. Organic traffic dropped about 25% after a site redesign six weeks ago. Focus on crawlability, indexation, title and heading quality, internal linking, and content gaps on money pages. If something cannot be verified from public fetch alone, say so clearly."

Pourquoi cela fonctionne :

• cela donne un contexte business
• cela définit le succès
• cela resserre le périmètre
• cela invite à une analyse fondée sur des preuves plutôt qu’à une fausse certitude

Respectez l’ordre d’audit prévu

Une erreur courante consiste à commencer par des retouches de copy. Cette skill est bien plus utile lorsqu’elle est utilisée dans l’ordre prévu :

1. Exploration et indexation
2. Fondamentaux techniques
3. Optimisation on-page
4. Qualité du contenu
5. Autorité et liens

Cet ordre change les résultats. Si des pages sont bloquées, mal canonicalisées ou mal reliées en interne, réécrire des meta descriptions ne réglera pas le problème de fond.

Ce que la skill seo-audit doit inspecter en pratique

D’après les signaux du repo et les attentes des evals, un bon seo-audit usage devrait inclure des vérifications telles que :

• robots.txt
• la présence et la qualité du sitemap XML
• les signaux d’indexation et de crawl
• l’architecture du site et la logique de maillage interne
• les balises title et meta descriptions
• la structure des headings
• la pertinence et l’optimisation du contenu
• les problèmes techniques probables qui nuisent à la découvrabilité ou aux performances

Elle doit ensuite organiser les constats dans un rapport exploitable pour la décision, et non dans une simple liste d’observations.

Respectez la limite sur la détection du schema

C’est un vrai point d’adoption, pas une note secondaire. La skill précise explicitement qu’il ne faut pas affirmer "no schema markup found" en se basant uniquement sur les résultats d’un simple fetch de page. Beaucoup de sites injectent le schema côté client ou d’une manière qu’un fetch basique ne détecte pas.

Une bonne sortie devrait dire quelque chose comme :

• "Schema markup could not be reliably verified from current fetch-based inspection."
• "Validate with rendered HTML, source inspection, or a schema testing workflow before concluding it is missing."

C’est ce qui rend la seo-audit skill plus fiable que des audits qui affichent un niveau de certitude excessif.

Utilisez la structure de rapport attendue

Pour un rendu exploitable lors du handoff, demandez à la skill de produire :

• Executive Summary
• Technical SEO Findings
• On-Page SEO Findings
• Content Findings
• Prioritized Action Plan

C’est important, car les parties prenantes n’agissent que rarement à partir de notes brutes. Elles agissent sur des problèmes hiérarchisés, avec justification, impact et prochaines étapes.

Appuyez-vous sur les evals pour juger la qualité de sortie

skills/seo-audit/evals/evals.json est l’un des meilleurs fichiers pour décider si cette skill mérite votre confiance et un usage régulier. Il montre les comportements attendus :

• poser des questions de clarification quand le contexte manque
• prioriser l’exploration et l’indexation avant la finition du contenu
• vérifier les bases de robots et du sitemap
• éviter les affirmations non fondées sur le schema
• présenter les constats dans une structure exploitable

Si votre agent ne fait pas cela, il ne suit pas vraiment bien la skill.

FAQ sur la skill seo-audit

Cette skill seo-audit convient-elle aux débutants

Oui, surtout pour les débutants qui ont besoin d’une séquence d’audit cohérente. Elle aide à éviter les vérifications SEO aléatoires et fournit un cadre de départ plus clair. Mais les débutants doivent quand même donner le contexte business, car la skill ne remplace pas la compréhension des pages et requêtes qui comptent vraiment.

En quoi est-ce différent de demander directement un audit SEO à une IA

Un prompt classique peut produire une liste plausible de conseils SEO. Cette skill est meilleure si vous voulez :

• un ordre d’audit défini
• de meilleures questions de cadrage
• moins d’affirmations non étayées
• un rapport final plus utile

Son principal avantage pratique n’est pas d’avoir "plus de fonctionnalités". C’est de réduire l’improvisation et d’améliorer la priorisation.

Puis-je utiliser seo-audit pour du SEO Content

Oui, avec les bonnes attentes. La skill prend en charge seo-audit for SEO Content en examinant l’optimisation on-page, la qualité du contenu et les problèmes probables de pertinence. Ce n’est pas avant tout un générateur de briefs de contenu. Utilisez-la pour diagnostiquer si les pages existantes sont alignées avec l’intention de recherche, les métadonnées, les headings et la structure du site, avant de décider quels contenus réécrire ou créer.

Faut-il un accès à Search Console ou aux analytics

Non. Vous pouvez l’utiliser avec une simple inspection publique du site. Mais le plafond de qualité sera plus bas. Sans Search Console, analytics ou exports de crawl, la skill peut identifier des problèmes probables, mais pas valider entièrement chaque affirmation sur la performance ou l’indexation.

Quand ne faut-il pas utiliser cette skill

Évitez cette skill si votre besoin principal est :

• d’ajouter ou débuguer uniquement du schema markup
• de générer à grande échelle des pages pour couvrir des mots-clés
• de travailler la visibilité dans les moteurs de recherche IA plutôt qu’un diagnostic SEO classique

Elle est aussi peu adaptée quand l’utilisateur veut une mise en œuvre immédiate des correctifs sans d’abord comprendre le problème sous-jacent.

La référence sur l’écriture est-elle vraiment utile

Oui, si la sortie d’audit doit être partagée à des clients ou publiée en interne. La référence dans references/ai-writing-detection.md n’est pas un fichier de framework SEO, mais elle améliore la qualité de restitution. Des recommandations plus propres, moins visiblement générées par une machine, sont généralement plus faciles à faire accepter et appliquer par les équipes.

Comment améliorer la skill seo-audit

Donnez à la skill seo-audit un meilleur contexte business

Le moyen le plus rapide d’améliorer la seo-audit skill est d’arrêter de la traiter comme un scanner générique. Dites-lui :

• qui est l’audience
• quelles pages comptent le plus
• quel événement de conversion est important
• ce qui a changé récemment
• quelles requêtes vous importent

Cela transforme l’audit, qui passe de simples "observations SEO" à de vraies "décisions SEO".

Réduisez le périmètre quand le site est vaste

Pour les grands sites, demandez plutôt l’un de ces périmètres au lieu d’un audit complet flou :

• la homepage plus les 5 pages de revenu les plus importantes
• un répertoire ou une section de blog
• un type de template
• un cluster touché par une perte de trafic

Des périmètres plus petits produisent des constats plus précis et des recommandations plus actionnables.

Demandez des preuves et des niveaux d’incertitude

Pour éviter une sortie vague, demandez :

• le problème observé
• pourquoi il compte
• le niveau de confiance
• le correctif recommandé
• l’impact attendu
• ce qui demande une validation complémentaire

C’est particulièrement utile pour les affirmations techniques et d’indexation, quand l’inspection publique reste incomplète.

Évitez les recommandations superficielles

Mode d’échec fréquent : la première sortie se focalise trop sur les titles, les mots-clés et des conseils génériques du type "améliorer la qualité du contenu".

Corrigez cela en demandant :

• les blocages de crawl et d’indexation en premier
• des patterns de templates de page, pas seulement des remarques de détail page par page
• les chemins de maillage interne vers les pages prioritaires
• les écarts entre l’intention business et les types de pages qui rankent

Cela permet à la seo-audit de rester centrée sur les vrais leviers, et non sur des retouches cosmétiques.

Fournissez des exemples de pages fortes et de pages faibles

Si vous savez quelles pages performent bien et lesquelles sous-performent, partagez les deux. La skill pourra alors comparer :

• le format des titles
• la profondeur des headings
• la structure du contenu
• les liens internes
• l’alignement avec l’intention
• l’alignement avec la conversion

Des entrées comparatives produisent souvent de meilleures recommandations qu’un audit à froid de tout le domaine.

Itérez après le premier audit

Le premier passage doit généralement produire une liste priorisée, pas une roadmap finale. Exemples de bons prompts de suivi :

• "Expand only the top 3 technical issues with validation steps."
• "Turn the content findings into page-specific rewrite priorities."
• "Separate quick wins from engineering-heavy fixes."
• "Map each recommendation to likely impact and effort."

C’est la meilleure façon de transformer le seo-audit usage en plan d’exécution.

Surveillez les affirmations excessives avec un accès limité

Si l’agent ne peut pas crawler, rendre le JavaScript ou inspecter les réglages de la plateforme, ne le laissez pas parler comme s’il avait une visibilité complète. La skill va déjà dans la bonne direction sur ce point. Conservez cette prudence. Elle améliore la confiance et réduit les faux positifs.

Utilisez la sortie comme couche de triage

Ce seo-audit guide fonctionne surtout comme une première couche de diagnostic avant un travail de spécialiste. Utilisez-le pour :

• identifier les blocages probables
• hiérarchiser les pistes d’investigation
• préparer des synthèses pour les parties prenantes
• décider s’il faut un approfondissement en SEO technique, en contenu, ou un support d’implémentation

C’est un rôle bien plus solide que d’attendre de la skill seule qu’elle remplace des outils SEO complets ou un accès direct au site en production.