Skills Claude : construire des procédures réutilisables pour vos tâches SEO récurrentes

Un skill Claude (appelé « compétence » dans l’interface française) est un dossier qui contient un fichier SKILL.md d’instructions, et si besoin des scripts, des gabarits et des documents de référence, que Claude charge uniquement quand la tâche le demande. Pour le SEO, les Claude Skills sont la façon la plus simple de transformer une procédure récurrente (audit, brief, reporting, contrôle avant mise en ligne) en méthode reproductible, au lieu de recoller le même prompt à chaque fois.

Ce guide détaille le fonctionnement d’un skill, ses différences avec les autres outils, la méthode de création et quatre exemples SEO concrets.

01Qu’est-ce qu’un skill Claude ?

Anthropic a présenté les Agent Skills le 16 octobre 2025, puis a publié le format comme standard ouvert en décembre 2025. Le principe tient en une phrase : donner à Claude une procédure écrite, avec ses outils, qu’il consulte seulement quand elle est utile.

Un skill ne rend pas Claude plus intelligent. Il lui apporte un contexte qu’il n’a pas : votre méthode, vos seuils, vos gabarits, vos interdits. C’est ce contexte procédural qui fait la différence entre une réponse générique et un livrable conforme à votre façon de travailler.

Un dossier d’instructions, de scripts et de références

Le seul fichier obligatoire est SKILL.md. Il commence par un en-tête YAML (le frontmatter) qui contient au minimum un nom et une description, suivi des instructions en Markdown. Le reste est optionnel :

brief-seo/
├── SKILL.md              # obligatoire : frontmatter + instructions
├── references/           # méthode détaillée, grilles, exemples
│   └── grille-intention.md
├── assets/               # gabarits (brief, rapport, tableau)
│   └── gabarit-brief.md
└── scripts/              # code exécutable (contrôles, calculs)
    └── controle_brief.py

• SKILL.md : la procédure, les règles et l’ordre des étapes.
• Références : la documentation longue, que Claude ne lit qu’au moment où il en a besoin.
• Gabarits : le format exact du livrable attendu.
• Scripts : les opérations où un programme est plus fiable qu’une génération de texte (dédoublonner un export, compter des caractères, valider un JSON).

Sur claude.ai, un skill personnalisé se téléverse sous forme d’archive ZIP. Dans Claude Code, il suffit de placer le dossier dans ~/.claude/skills/ (skills personnels) ou dans .claude/skills/ à la racine d’un projet (skills partagés avec le dépôt).

Comment Claude choisit et charge un skill à la demande

Claude ne lit pas tous vos skills à chaque conversation. Il fonctionne par chargement progressif, en trois niveaux décrits dans la documentation Agent Skills d’Anthropic :

Conséquence directe : la description est l’aiguillage du skill. Si elle est vague, Claude ne le déclenche pas, ou le déclenche à tort. Vous pouvez aussi appeler un skill explicitement : dans Claude Code, le nom du dossier devient une commande (par exemple /brief-seo).

Où utiliser les skills : claude.ai, Claude Code et API

Le format est le même partout, mais l’installation et le partage diffèrent :

Un skill téléversé sur claude.ai doit être ajouté séparément côté API : gardez une seule source de vérité (un dépôt Git, par exemple) pour éviter les versions divergentes.

02Skill, prompt, projet, GPT personnalisé ou serveur MCP : les différences

Ces notions se recoupent souvent, mais elles ne jouent pas le même rôle :

Skill ou prompt enregistré

Un prompt est une consigne, un skill est une procédure. Le prompt doit être recollé, il n’embarque ni script ni gabarit, et il dérive un peu à chaque réécriture. Le skill est versionné, se déclenche seul et peut confier à un script les vérifications que le modèle fait mal (compter des caractères, comparer deux listes d’URL).

Le bon réflexe : quand vous recollez sans cesse la même consigne, la même checklist ou la même procédure en plusieurs étapes, elle mérite un skill. Les principes de rédaction restent ceux d’un bon prompt, détaillés dans le guide du prompt engineering pour le SEO.

Skill, projet Claude ou GPT personnalisé

D’après la page d’aide d’Anthropic sur les compétences, un projet fournit des connaissances de base statiques, toujours chargées dans ses conversations, alors qu’un skill est une procédure spécialisée, activée au besoin et disponible partout. Les deux se combinent bien : le projet porte le contexte d’un site (documents, historique), le skill porte la méthode.

Un GPT personnalisé ressemble davantage à un assistant dédié : vous choisissez de l’ouvrir, puis il applique ses instructions. Un skill est sélectionné par Claude au fil de la conversation, et plusieurs skills peuvent se combiner. Le format Agent Skills est en outre ouvert, alors qu’un GPT reste propre à ChatGPT. Pour comparer les deux assistants, voir Claude ou ChatGPT pour l’analyse de contenu SEO.

Skill ou serveur MCP : un savoir-faire contre un accès aux données

Un serveur MCP (Model Context Protocol) connecte Claude à Search Console, GA4, Ahrefs ou un CMS. Il donne l’accès, mais il ne dit pas quoi regarder, dans quel ordre, ni quels seuils retenir. Le skill apporte exactement cela : la méthode.

Un skill de reporting mensuel peut donc s’appuyer sur deux ou trois serveurs MCP pour lire les données, puis appliquer votre procédure d’analyse. Pour comprendre le protocole lui-même, voir l’article sur le serveur MCP et le standard derrière les agents IA connectés.

03Créer un skill Claude pour une tâche SEO en cinq étapes

La méthode vaut pour claude.ai comme pour Claude Code. Le skill « skill-creator » d’Anthropic peut produire un premier jet de l’arborescence et du fichier SKILL.md, à relire règle par règle.

1. Choisir une tâche récurrente et écrire la procédure

Le meilleur candidat est une tâche fréquente, réalisée toujours de la même façon, et dont le résultat se vérifie. Avant d’ouvrir un éditeur, écrivez la procédure comme vous l’expliqueriez à un consultant junior :

• Les entrées : ce que vous fournissez (mot-clé, export de crawl, URL, période).
• Les étapes, dans l’ordre, avec les décisions à prendre à chacune.
• Les règles : seuils, formats, interdits, sources autorisées.
• La sortie : format exact, nom de fichier, destinataire.
• Le contrôle : comment savoir que le résultat est correct.

Si vous ne savez pas écrire l’étape « contrôle », la tâche n’est pas encore assez stabilisée pour devenir un skill.

2. Rédiger le fichier SKILL.md : nom, description et déclencheurs

Le frontmatter contient deux champs obligatoires. Le nom compte 64 caractères au maximum, en minuscules, chiffres et traits d’union, sans les mots réservés « anthropic » et « claude ». La description, limitée à 1 024 caractères, doit dire à la fois ce que fait le skill et quand l’utiliser. Exemple de début de fichier pour un skill de brief éditorial :

---
name: brief-seo
description: >
  Produit un brief éditorial SEO à partir d'un mot-clé (top 10,
  intention, plan Hn, questions, maillage interne). À utiliser quand
  l'utilisateur demande un brief, un plan d'article ou une structure Hn.
  Ne pas utiliser pour rédiger l'article complet.
---

# Brief éditorial SEO

## Entrées
- Mot-clé, pays, page cible

## Étapes
1. Récupérer le top 10 et les questions associées.
2. Lire les trois premières pages organiques : Hn, format, longueur.
3. Déduire l'intention et le type de page attendu.
4. Remplir le gabarit assets/gabarit-brief.md.
5. Lancer scripts/controle_brief.py et corriger les erreurs.

## Règles
- Ne jamais inventer de chiffre ni de source.

Trois règles pour une description qui déclenche bien :

1. Commencer par le cas d’usage principal, en termes concrets.
2. Reprendre les formulations réelles qui doivent déclencher le skill (« brief », « plan d’article », « structure Hn »).
3. Préciser ce que le skill ne fait pas, pour éviter les confusions entre skills voisins.

Dans Claude Code, des champs supplémentaires existent. Par exemple, disable-model-invocation: true réserve le skill à un appel manuel, utile pour une action sensible comme une publication. Ce champ est une extension propre à Claude Code : un skill destiné à claude.ai ou à l’API doit s’en tenir aux champs de la spécification (name, description, license, compatibility, metadata, allowed-tools).

3. Ajouter références, gabarits et scripts

SKILL.md doit rester court. La documentation de Claude Code sur les skills recommande de le garder sous 500 lignes et de déplacer le détail dans des fichiers séparés, car le corps d’un skill reste en contexte une fois chargé.

• Références : grille d’intention de recherche, règles de maillage, liste des URL du site, exemples de bons et de mauvais livrables.
• Gabarits : le squelette exact du brief, du rapport ou du tableau, avec les intitulés imposés.
• Scripts Python : contrôles déterministes (longueur du title, caractères interdits, liens internes autorisés, JSON valide), calculs et dédoublonnage d’exports.

Indiquez dans SKILL.md quand lire chaque fichier (« lire references/maillage.md avant de proposer des liens »). Sans cette consigne, Claude peut ignorer une ressource utile ou en charger trop.

4. Poser les garde-fous : périmètre, données sensibles, validation humaine

Un skill exécute votre procédure avec assurance, y compris quand elle est incomplète. Les garde-fous doivent donc être écrits noir sur blanc :

• Périmètre : ce que le skill fait, ce qu’il refuse, et quand il doit s’arrêter pour poser une question.
• Données sensibles : aucun identifiant ni clé d’API dans les fichiers, aucune donnée client nominative dans les exemples.
• Actions irréversibles : publication, suppression ou envoi d’e-mail soumis à une validation explicite.
• Sources : interdiction d’inventer un chiffre, obligation de citer la source et la date.
• Sortie contrôlée : un script de vérification lancé avant de rendre le livrable.

5. Tester sur des cas réels et améliorer le skill en continu

Un skill se teste comme une procédure : sur des cas réels, avec des résultats attendus écrits à l’avance.

1. Test de déclenchement : quelques demandes qui doivent l’activer, et autant de demandes proches qui ne doivent pas l’activer.
2. Test de résultat : des cas déjà traités à la main, pour comparer le livrable du skill au vôtre.
3. Test de cas limites : données manquantes ou export mal formé. Le skill doit s’arrêter et demander.
4. Journal des écarts : chaque correction faite à la main devient une règle ou un exemple dans le skill.
5. Versionnement : le dossier vit dans un dépôt Git, avec une ligne de changelog par modification.

Un skill qui n’a jamais été corrigé n’a probablement jamais été vraiment testé.

04Quatre skills SEO utilisés au quotidien

Ces quatre skills couvrent des tâches récurrentes de mes missions. Leur intérêt est la constance du livrable, pas une promesse de résultat.

Audit technique à partir d’un export de crawl

Le skill part d’un export Screaming Frog et, si possible, de la liste des URL indexées issue de Search Console. Un script dédoublonne et segmente les URL par gabarit (catégories, fiches, blog). Claude interprète ensuite les écarts : pages crawlées non indexées, pages indexées absentes du crawl, redirections en chaîne, canonical contradictoires.

La règle clé : toute conclusion est vérifiée sur un échantillon d’URL réelles avant d’entrer dans le livrable. Cette logique de contrôle humain est détaillée dans l’article sur l’audit SEO assisté par l’IA sans perdre le contrôle.

Brief éditorial à partir d’un mot-clé

Le skill récupère la SERP, lit les premières pages, puis remplit un gabarit fixe : intention, type de page attendu, plan Hn, questions à couvrir, longueur cible, maillage interne. Avec un serveur MCP connecté à un outil SEO, il lit directement le top 10 et ses métriques au lieu de travailler sur un export.

Le garde-fou le plus utile est la liste des URL du site fournie en référence : le skill ne peut proposer qu’un lien qui existe, ce qui évite les liens inventés.

Reporting mensuel SEO et GEO

Le skill fixe la structure du rapport (synthèse, trafic organique, conversions, requêtes, pages, visibilité dans les IA, actions du mois suivant) et la définition de chaque indicateur. Les données arrivent par des serveurs MCP connectés à GA4 et à Search Console, ou par un export quand aucun connecteur n’existe.

Ce qui change avec un skill : les mêmes indicateurs, calculés de la même façon, chaque mois. La relecture humaine reste obligatoire, car une variation se commente avec le contexte du site (saisonnalité, mise à jour Google). Pour la chaîne complète, de la collecte à l’envoi, voir les workflows d’automatisation SEO avec n8n.

Contrôle d’une page avant mise en ligne

C’est souvent le meilleur premier skill, car il est simple et très répétitif. Il vérifie une page avant publication à partir d’une checklist et d’un script :

• Title et meta description : présence, longueur, mot-clé, unicité.
• Structure : un seul H1, hiérarchie Hn cohérente, premier paragraphe qui répond à l’intention.
• Liens : liens internes autorisés uniquement, ancres descriptives, aucun lien cassé ou en double.
• Données structurées : JSON-LD valide et cohérent avec le contenu visible.
• Règles éditoriales : formulations interdites, mentions obligatoires.

Le skill produit une liste d’anomalies classées en bloquantes et mineures. Il ne corrige rien sans accord : la décision de publier reste humaine.

05Agents SEO tout-en-un et skills partagés : ce qu’il faut en attendre

Sur LinkedIn, les « agents SEO tout-en-un » se multiplient : packs de skills pour Claude Code, Cursor ou Codex, agents d’éditeurs d’outils SEO, dépôts GitHub de centaines de skills. Le standard Agent Skills est en effet pris en charge par de nombreux outils, dont Codex, Cursor, GitHub Copilot et Gemini CLI.

Ces packs ont une vraie valeur d’inspiration. Ils ont aussi trois limites :

• Ils encodent la méthode de quelqu’un d’autre, avec ses seuils et ses angles morts.
• Ils ne fournissent pas les données : sans accès à Search Console, GA4 ou un outil SEO, un « agent d’audit » travaille uniquement sur ce que vous lui donnez.
• Leur qualité et leur sécurité varient fortement.

Sur ce dernier point, l’étude ToxicSkills publiée par Snyk le 5 février 2026 a analysé 3 984 skills issus de deux places de marché publiques (ClawHub et skills.sh) : 36,82 % présentaient au moins une faille de sécurité et 13,4 % au moins un problème critique, selon l’analyse publiée par Snyk.

La bonne posture : lire ces packs, réécrire les règles avec votre méthode, puis tester. Un agent ne remplace pas le diagnostic, il exécute une procédure (voir l’article sur les agents IA autonomes et leur effet sur le SEO). Pour cadrer un agent sur vos propres processus, la page consacrée à la conception d’un agent IA sur mesure détaille la démarche.

06Erreurs à éviter avec les Claude Skills

La plupart des skills décevants partagent les mêmes défauts :

• Une description trop vague (« aide pour le SEO ») : le skill ne se déclenche pas, ou se déclenche partout.
• Un SKILL.md fourre-tout : toute la documentation dans un seul fichier, qui alourdit le contexte à chaque usage.
• Des skills qui se chevauchent : deux skills « audit » aux descriptions proches, que Claude confond.
• Aucun script de contrôle : le modèle vérifie lui-même ce qu’il a produit, ce qu’il fait mal pour les comptages et les listes.
• Des secrets dans les fichiers : clés d’API, identifiants ou données clients copiés dans les références.
• Aucune boucle d’amélioration : les mêmes corrections faites à la main chaque semaine, jamais reportées dans le skill.

Un bon skill est court, précis, testé et corrigé régulièrement : moins spectaculaire qu’un agent tout-en-un, mais bien plus fiable.

07Questions fréquentes

Les Claude Skills sont-ils gratuits ?

Les skills n’ont pas de prix spécifique : ils sont inclus dans les offres Claude, à condition que l’exécution de code soit activée. La page d’aide d’Anthropic cite les offres Free, Pro, Max, Team et Enterprise, tandis que la documentation développeur réserve le téléversement de skills personnalisés aux offres payantes. Sur l’API, un skill consomme des tokens comme le reste de la requête. Vérifiez les conditions de votre offre avant un déploiement en équipe.

Comment installer un skill sur Claude ?

Sur claude.ai, activez l’exécution de code, puis ouvrez le menu Personnaliser, rubrique Compétences, pour parcourir le répertoire ou téléverser votre skill au format ZIP. Dans Claude Code, copiez le dossier du skill dans ~/.claude/skills/ pour un usage personnel, ou dans le dossier .claude/skills/ d’un projet pour le partager avec le dépôt. Côté API, les skills se gèrent avec l’endpoint /v1/skills.

Comment Claude décide-t-il d’utiliser un skill ?

Au démarrage, Claude ne lit que le nom et la description de chaque skill disponible. Quand votre demande correspond à une description, il charge les instructions complètes, puis lit les références ou lance les scripts seulement si la procédure l’exige. La description fait donc office d’aiguillage : elle doit dire précisément ce que fait le skill, quand l’utiliser et quand ne pas l’utiliser.

Un skill Claude peut-il être dangereux ?

Oui, s’il provient d’une source non fiable. Un skill peut contenir des scripts exécutés par Claude et des instructions qui orientent ses actions. Anthropic recommande de n’utiliser que des skills créés par vous ou par une source de confiance, et d’auditer chaque fichier, notamment les appels réseau inattendus. Pour un skill trouvé sur GitHub ou sur une place de marché, lisez tout avant de l’installer.