Skills Claude pour non-développeurs : quoi mettre dans un skill, un projet ou un fichier .md

Un skill Claude est un dossier qui contient un fichier SKILL.md : un nom, une description, puis des instructions. Claude ne lit ces instructions que lorsque votre demande correspond à la description. C’est l’endroit où ranger une procédure que vous répétez, par exemple un devis dans votre format ou une réponse aux avis clients dans votre ton.

Ce guide donne une règle simple pour savoir où va chaque consigne, puis construit deux skills de bout en bout : les fichiers à télécharger, l’installation, le test et la correction. Le centre d’aide d’Anthropic en français appelle les skills « compétences » : c’est sous ce nom qu’il décrit le menu Personnaliser > Compétences.

Skill, projet, CLAUDE.md : où ranger chaque consigne

Les vidéos se contredisent souvent sur ce point, parce que tout s’écrit au même format. Un SKILL.md, un CLAUDE.md et un fichier de référence sont tous des fichiers texte .md (le format Markdown). Ce qui les distingue, c’est le moment où Claude les lit.

Les instructions personnalisées, vos préférences générales, s’appliquent à toutes vos conversations. Règle : ce qui vaut pour tout ce que vous demandez, comme « vouvoie toujours mes clients ».

Les instructions d’un projet s’appliquent à chaque conversation ouverte dans ce projet, avec les documents que vous y avez déposés. Règle : le contexte d’un dossier précis, un client, un chantier, une saison. Anthropic résume la différence ainsi : un projet apporte un contexte toujours chargé, un skill apporte une procédure qui s’active quand elle sert, dans toutes vos conversations. Pour ce que Claude retient seul d’une conversation à l’autre, voyez ce que garde la mémoire de Claude.

Un skill se charge à la demande, partout. Règle : une tâche que vous expliquez pour la troisième fois, avec le même format et les mêmes exigences.

Le fichier CLAUDE.md appartient à Claude Code, l’outil d’Anthropic qui travaille dans les dossiers de votre ordinateur. Claude le lit au début de chaque session ouverte dans ce dossier. Règle : les faits permanents de ce dossier, en quelques lignes. La documentation de Claude Code conseille d’en sortir toute procédure en plusieurs étapes pour en faire un skill.

Un fichier de référence est un document que Claude consulte : une grille de prix, des exemples de réponses, une charte graphique. Rangé dans le dossier d’un skill, il n’est lu que lorsque les instructions y renvoient. Règle : les données d’un côté, les consignes de l’autre.

Les connecteurs sont une brique de plus. Ils donnent à Claude l’accès à un outil, votre messagerie ou votre agenda par exemple, alors qu’un skill lui apprend une méthode. Les deux se combinent. Pour les mettre en place, voyez connecter Claude à Gmail, Drive et Agenda.

Comment Claude charge un skill

Selon la documentation d’Anthropic, Claude lit un skill en trois temps. Au démarrage, il ne voit que le nom et la description de chaque skill, environ une centaine de jetons par skill. Quand une demande correspond à une description, il lit le corps du SKILL.md. Il ouvre ensuite les fichiers de référence au moment où les instructions les citent.

Conséquence pratique : la description décide de tout. Elle doit dire ce que fait le skill et quand l’utiliser, avec les mots que vous employez vraiment (« devis », « offre de prix », « chiffrage »). Avec une description vague, le skill risque de ne pas se déclencher. Seuls le nom et la description de chaque skill restent chargés en permanence, ce qui permet, selon Anthropic, d’en installer beaucoup sans encombrer vos conversations. Pour ce qui use vraiment votre forfait, voyez la limite atteinte sur Claude Pro.

Où fonctionnent les skills aujourd’hui

Vérifié le 6 octobre 2026 dans la documentation, le centre d’aide et la page des tarifs d’Anthropic :

• Dans claude.ai et les applications Claude, les skills sont ouverts à toutes les formules, gratuite comprise. Il faut que l’exécution de code et la création de fichiers soit activée dans Paramètres > Capacités ; en Team et Enterprise, ce réglage dépend du propriétaire de l’organisation. Les vôtres s’ajoutent dans Personnaliser > Compétences, sous forme de fichier ZIP.
• Dans Claude Code, un skill est un simple dossier : dans ~/.claude/skills/ pour tous vos projets, ou dans .claude/skills/ à l’intérieur d’un projet. Claude Code est inclus dans toutes les formules payantes ; pour choisir la vôtre, voyez quel abonnement Claude prendre.
• Dans l’API Claude, les skills passent par l’outil d’exécution de code et se téléversent avec l’API Skills. Cette voie concerne surtout les développeurs.

Ces emplacements ne se synchronisent pas entre eux : un skill téléversé sur claude.ai n’existe pas dans l’API, et un dossier posé sur votre ordinateur n’apparaît pas sur claude.ai. Seule exception, depuis la version 2.1.273 de Claude Code, les skills activés dans votre compte claude.ai se chargent aussi dans Claude Code quand vous vous y connectez avec le même compte, dans ce sens seulement. Ils sont également disponibles dans les compléments Claude pour Excel, Word, PowerPoint et Outlook.

Pour un usage professionnel, lisez les conditions d’utilisation d’Anthropic avant de prendre une formule individuelle pour votre entreprise.

Ce que le fichier SKILL.md doit contenir

Le fichier commence par un en-tête placé entre deux lignes de trois tirets, puis viennent les instructions en texte libre. L’en-tête a deux champs obligatoires.

• name : minuscules, chiffres et tirets simples, 64 caractères au maximum, identique au nom du dossier, sans les mots « claude » ni « anthropic ».
• description : ce que fait le skill et quand l’utiliser. La spécification ouverte des skills autorise 1 024 caractères, le centre d’aide indique 200 caractères pour un envoi sur claude.ai : restez sous 200.

La spécification prévoit quatre champs facultatifs : license, compatibility, metadata et allowed-tools. Avec name et description, ce sont les seuls qu’accepte un envoi sur claude.ai. Claude Code accepte d’autres champs, mais l’envoi sur claude.ai échoue si l’en-tête en contient un autre. Gardez le corps du fichier sous 500 lignes et placez le reste dans des fichiers de référence, un niveau sous le SKILL.md.

Skill 1 : rédiger un devis dans votre format

L’exemple suit une entreprise de peinture fictive, l’Atelier Lenoir à Tournai. Remplacez ses coordonnées et ses prix par les vôtres avant de l’activer. Le dossier complet est à télécharger : devis-maison.zip.

Étape 1 : créer le dossier

Créez un dossier nommé devis-maison, avec ce contenu :

devis-maison/
├── SKILL.md
└── references/
    ├── tarifs.md
    └── entreprise.md

Un éditeur de texte simple suffit, Bloc-notes sous Windows ou TextEdit en texte brut sur Mac. Enregistrez chaque fichier avec l’extension .md.

Étape 2 : écrire le SKILL.md

Copiez ce texte dans devis-maison/SKILL.md :

---
name: devis-maison
description: Rédige un devis de travaux de peinture au format de l'Atelier Lenoir à partir de notes de visite. À utiliser quand l'utilisateur demande un devis, une offre de prix ou un chiffrage de chantier.
---

# Devis au format de l'Atelier Lenoir

## Ce qu'il te faut avant d'écrire
1. Le nom du client et l'adresse du chantier.
2. Les surfaces ou quantités de chaque poste (m², unités, forfaits).
3. Le taux de TVA. Il vient toujours de l'utilisateur. S'il manque, demande-le
   et n'écris pas le devis. Ne choisis jamais toi-même un taux réduit.

S'il manque une surface ou une quantité, demande-la. N'estime rien.

## Prix et coordonnées
- Prix unitaires : lis references/tarifs.md. N'utilise aucun autre prix.
  Un poste absent de la grille devient une ligne « à chiffrer » sans montant.
- Coordonnées, conditions et mentions : lis references/entreprise.md et
  recopie-les mot pour mot.

## Format du devis (dans cet ordre)
1. En-tête : coordonnées de l'entreprise, puis « Devis n° » suivi de
   la date du jour et du nom de famille du client en majuscules, sans
   civilité ni prénom. Exemple : Devis n° 2026-10-06-FONTAINE.
2. Client : nom, adresse du chantier.
3. Objet : une phrase qui décrit les travaux.
4. Tableau : Poste | Quantité | Unité | Prix unitaire HT | Total HT.
5. Totaux : Total HT, TVA (taux indiqué), Total TTC, acompte demandé.
6. Conditions et mentions de references/entreprise.md.
7. Une ligne « Bon pour accord, date et signature du client ».

## Calculs
- Calcule chaque total avec l'outil d'exécution de code, jamais de tête.
- Montants en euros, deux décimales, virgule décimale, espace pour les
  milliers (1 254,00 €).
- Acompte : le pourcentage de references/entreprise.md appliqué au Total TTC.

## Après le devis
Ajoute sous le devis une courte liste « À vérifier avant envoi » : chaque
hypothèse que tu as faite et chaque ligne « à chiffrer ».

Adaptez la description à votre métier : c’est elle qui déclenche le skill. Quatre choix comptent ensuite dans ce fichier :

• le taux de TVA vient toujours de vous, car en Belgique comme en France les taux réduits des travaux dans un logement ont des conditions ;
• une quantité manquante déclenche une question, sans estimation ;
• les calculs passent par l’exécution de code, plus fiable qu’un calcul fait de tête ;
• la liste « À vérifier » rend visibles les hypothèses de Claude.

Étape 3 : ajouter les fichiers de référence

Votre grille de prix va dans references/tarifs.md :

# Grille de prix de l'Atelier Lenoir (exemple fictif, prix HT)

| Poste | Unité | Prix unitaire HT |
|---|---|---|
| Peinture murs, deux couches, finition mate | m² | 18,50 € |
| Peinture plafond, deux couches | m² | 21,00 € |
| Rebouchage et ponçage des fissures | forfait par pièce | 120,00 € |
| Protection des sols et du mobilier | forfait par chantier | 60,00 € |
| Déplacement | forfait par chantier | 35,00 € |

Vos coordonnées et vos conditions vont dans references/entreprise.md :

# Atelier Lenoir (entreprise fictive)

Atelier Lenoir, peinture et décoration
Rue des Exemples 12, 7500 Tournai, Belgique
Tél. 0470 00 00 00, contact@atelier-lenoir.example
Numéro d'entreprise : 0000.000.000 (fictif)

## Conditions
- Devis valable 30 jours à compter de sa date.
- Acompte de 30 % du Total TTC à la signature, solde à la fin des travaux.
- Délai d'exécution confirmé à la signature, selon le planning.
- Toute modification des travaux fait l'objet d'un avenant écrit.

Reprenez dans ce fichier les mentions de votre devis actuel. Les mentions obligatoires ne sont pas les mêmes en France et en Belgique, et le skill ne vérifie pas qu’elles sont complètes : faites valider ce modèle une fois par votre comptable.

Étape 4 : l’installer

Dans claude.ai :

1. Ouvrez Paramètres > Capacités et vérifiez que l’exécution de code et la création de fichiers est activée.
2. Compressez le dossier devis-maison lui-même en ZIP. À l’ouverture du ZIP, on doit trouver le dossier devis-maison, avec les fichiers à l’intérieur.
3. Ouvrez Personnaliser > Compétences, cliquez sur « + », puis « + Créer une compétence » et « Télécharger une compétence ».
4. Choisissez le ZIP. Le skill apparaît dans votre liste : vérifiez qu’il est activé.

Les libellés sont ceux du centre d’aide d’Anthropic en français au 6 octobre 2026 ; l’interface peut les formuler un peu autrement.

Dans Claude Code, copiez le dossier dans ~/.claude/skills/ (tous vos projets) ou dans .claude/skills/ d’un projet. Le skill devient aussi une commande : tapez /devis-maison pour l’appeler directement.

Étape 5 : le tester

Ouvrez une nouvelle conversation et demandez la tâche comme d’habitude, sans citer le skill :

Peux-tu me préparer le devis pour Mme Claire Fontaine (cliente fictive), chantier rue du Parc 8, 7500 Tournai ? Salon : murs 38 m² (portes et fenêtre déduites), plafond 16 m², des fissures à reboucher dans la pièce, protection des sols et du mobilier, déplacement. TVA 6 %, taux validé de mon côté.

Faites deux contrôles. D’abord, le raisonnement affiché par Claude doit mentionner la lecture du skill devis-maison ; sinon, la description ne correspond pas à votre façon de demander. Ensuite, les chiffres doivent tomber juste avec la grille d’exemple :

• murs 703,00 €, plafond 336,00 €, rebouchage 120,00 €, protection 60,00 €, déplacement 35,00 € ;
• Total HT 1 254,00 €, TVA à 6 % 75,24 €, Total TTC 1 329,24 € ;
• acompte de 30 % du TTC : 398,77 € ;
• un numéro de devis daté, la ligne de signature et la liste « À vérifier ».

Testez aussi un cas incomplet, ici sans taux de TVA :

Prépare-moi un devis pour M. Hugo Marchal (client fictif), chantier avenue des Tilleuls 3, 7500 Tournai : chambre, murs 32 m², plafond 12 m², déplacement.

Résultat attendu : une question sur le taux de TVA, et aucun devis.

Un troisième test vérifie la grille : demandez un poste qu’elle ne contient pas, de la pose de papier peint par exemple. Il doit sortir en ligne « à chiffrer », sans montant, et revenir dans la liste « À vérifier ».

Étape 6 : le corriger

Ce qui a été vérifié pour ce guide, le 6 octobre 2026 : les deux dossiers respectent la spécification ouverte des skills et les contraintes de claude.ai (nom, description, fichiers cités présents, ZIP au bon format), et Claude Code 2.1.280 les détecte au démarrage, comme skills et comme commandes /devis-maison et /reponses-avis-clients.

Claude lui-même n’a rédigé aucune réponse pendant ces essais. Les instructions ont été testées avec un autre modèle de langage, en reproduisant le chargement en deux temps : la description seule, puis les instructions et les fichiers. Les montants étaient justes, la demande sans TVA a produit une question et le papier peint une ligne « à chiffrer ». Ce test ne remplace pas le vôtre dans votre compte Claude.

Le test a aussi trouvé un défaut. La première version demandait « AAAA-MM-JJ-NOM » pour le numéro de devis, et la sortie a donné « 2026-10-06-MME CLAIRE FONTAINE ». La règle est devenue : « la date du jour et le nom de famille du client en majuscules, sans civilité ni prénom. Exemple : Devis n° 2026-10-06-FONTAINE. » Au test suivant, le numéro était correct.

La méthode vaut pour tout skill : une erreur, une ligne corrigée, un exemple ajouté, un nouveau test. Si Claude n’utilise pas le skill, reprenez la description avec les mots de vos demandes, ou citez le skill par son nom. Dans claude.ai, vous pouvez aussi demander à Claude de modifier le skill dans la conversation, puis enregistrer la nouvelle version.

Skill 2 : répondre aux avis clients dans votre ton

Même entreprise fictive. Le dossier complet : reponses-avis-clients.zip.

reponses-avis-clients/
├── SKILL.md
└── references/
    └── exemples-reponses.md

Le SKILL.md :

---
name: reponses-avis-clients
description: Rédige la réponse publique à un avis client Google ou Facebook dans le ton de l'Atelier Lenoir. À utiliser quand l'utilisateur colle un avis client ou demande de répondre à un avis.
---

# Répondre aux avis clients dans le ton de l'Atelier Lenoir

## Le ton
- Vouvoiement, phrases courtes, chaleureux et sobre.
- Remercie la personne par son prénom s'il apparaît dans l'avis, sinon
  « Bonjour, ».
- Reprends un détail précis de l'avis pour montrer qu'il a été lu.
- Signe toujours : « Julien, Atelier Lenoir ».
- Réponds dans la langue de l'avis.
- Entre 40 et 90 mots.

## Avis positif (4 ou 5 étoiles)
Remercie, cite le détail, termine par une phrase simple sur la suite
(un prochain chantier, une recommandation). Pas de promotion ni de code promo.

## Avis négatif ou mitigé (1 à 3 étoiles)
1. Remercie pour le retour.
2. Reconnais le problème décrit, sans le minimiser et sans te justifier.
3. N'invente aucune cause, aucun fait, aucun geste commercial.
4. Ne reconnais aucune faute juridique et ne parle pas d'argent en public.
5. Invite la personne à appeler le 0470 00 00 00 pour en parler.

## Interdits
- Données personnelles du client (adresse, téléphone, détails du chantier
  qu'il n'a pas écrits lui-même).
- Formules toutes faites : « Votre satisfaction est notre priorité »,
  « Nous prenons note de vos remarques ».
- Tirets longs, émojis, points d'exclamation en série.

## Exemples
Lis references/exemples-reponses.md avant d'écrire : ce sont des réponses
déjà validées par l'atelier, le niveau attendu.

## Livraison
Donne la réponse prête à coller, puis une ligne « À vérifier » si l'avis
mentionne un fait que tu ne peux pas confirmer.

Les exemples comptent plus que la description du ton. Anthropic conseille de coller une réponse réussie dans le skill : elle montre votre niveau d’exigence mieux qu’une liste d’adjectifs. Mettez-en au moins deux, un avis positif et un avis négatif, avec vos vraies réponses et sans le nom de famille des clients. Le fichier references/exemples-reponses.md :

# Réponses validées (exemples fictifs)

## Avis 5 étoiles
Avis : « Travail soigné dans notre cuisine, équipe ponctuelle et très propre. Merci ! » (Thomas)
Réponse : Merci Thomas. Une cuisine se repeint en vivant dedans, alors nous
faisons attention à la propreté chaque soir. Contents que cela se soit vu.
Si vous attaquez un jour le couloir, vous savez où nous trouver.
Julien, Atelier Lenoir

## Avis 2 étoiles
Avis : « Résultat correct mais le chantier a pris trois jours de plus que prévu. » (Nadia)
Réponse : Bonjour Nadia, merci d'avoir pris le temps d'écrire. Trois jours
de plus, c'est trois jours de plus chez vous avec un chantier ouvert, et
nous comprenons que cela pèse. Nous aimerions en parler avec vous pour
comprendre ce qui a coincé. Pouvez-vous nous appeler au 0470 00 00 00 ?
Julien, Atelier Lenoir

Installez-le comme le premier, puis testez avec cet avis fictif :

Un avis Google vient d'arriver, 2 étoiles, signé Sophie : « Peinture correcte mais l'équipe est arrivée avec deux heures de retard le premier jour et personne ne m'a prévenue. Dommage. » Tu peux me proposer une réponse ?

Réponse obtenue le 6 octobre 2026 lors du test décrit plus haut, donc produite par un autre modèle de langage que Claude :

Bonjour Sophie, merci d’avoir pris le temps de nous écrire. Attendre deux heures le premier jour sans avoir été prévenue est une situation décevante, même si la peinture est correcte. Nous comprenons votre remarque et aimerions en parler avec vous. Pouvez-vous nous appeler au 0470 00 00 00 ?
Julien, Atelier Lenoir

Contrôlez cinq points : le prénom, le détail repris (le retard et l’absence de prévenance), aucune cause inventée, le numéro de téléphone, la signature. La réponse fait 52 mots, dans la fourchette. Elle était suivie d’une ligne « À vérifier » sur le retard, un fait que le modèle ne peut pas confirmer.

Relisez toujours avant de publier : au test d’un avis 5 étoiles, la réponse ajoutait une précision sur les finitions que le client n’avait pas écrite. Le skill rédige un texte ; c’est vous qui le copiez dans votre fiche d’établissement Google ou sur votre page Facebook. Pour vos publications elles-mêmes, voyez comment préparer vos posts LinkedIn et Instagram avec Claude. Ne mettez pas dans un skill des données de clients dont il n’a pas besoin.

Créer un skill en conversation, sans écrire de fichier

Anthropic propose une seconde voie, sans éditeur de texte. Ouvrez une nouvelle conversation, joignez un devis ou une réponse dont vous êtes content, et décrivez ce que vous voulez :

Je veux créer un skill pour répondre aux avis Google de mon entreprise.
Le format : 40 à 90 mots, le prénom du client, un détail de son avis
repris, ma signature « Julien, Atelier Lenoir ». Le ton : vouvoiement,
chaleureux et sobre, jamais de justification. Voici deux réponses dont je
suis content : [collez-les]. Pose-moi tes questions avant d'écrire le skill.

Claude pose des questions sur votre méthode, s’appuie sur son skill de création de skills (skill-creator), puis produit un skill complet que vous enregistrez et retrouvez dans Personnaliser > Compétences. Le guide d’Anthropic résume ce qu’il faut lui donner en trois points : le format, le ton et un exemple réussi.

Écrire les fichiers à la main garde un avantage : vous savez exactement ce que contient le skill.

Quels skills installer pour construire un site

Anthropic publie des skills d’exemple dans son dépôt public anthropics/skills, 19 au 6 octobre 2026. Le dépôt précise qu’ils servent à la démonstration et à l’apprentissage, et que le comportement obtenu dans Claude peut différer. Pour un site, quatre méritent un essai :

• frontend-design guide les choix visuels, typographie et direction graphique, pour éviter l’aspect « gabarit par défaut » que l’on reproche aux sites faits avec l’IA ;
• theme-factory applique l’un de ses dix thèmes de couleurs et de polices à une page ou à un document, pratique pour comparer des variantes ;
• webapp-testing teste avec Playwright un site qui tourne sur votre ordinateur, dans Claude Code ;
• skill-creator aide à créer, tester et améliorer vos propres skills.

Les autres peuvent attendre. web-artifacts-builder vise les artefacts complexes en React, trop lourd pour une page vitrine ; pour les outils simples, voyez les artefacts Claude utiles aux indépendants. brand-guidelines applique la charte d’Anthropic et sert surtout de modèle pour votre propre skill de charte. algorithmic-art, canvas-design et slack-gif-creator sortent du sujet, et mcp-builder concerne ceux qui développent des connecteurs.

Pour les installer dans Claude Code, tapez /plugin marketplace add anthropics/skills, puis /plugin install example-skills@anthropic-agent-skills : cette commande installe d’un coup les douze skills d’exemple du lot, ces quatre compris. Dans claude.ai, les compétences d’exemple s’activent dans Personnaliser > Compétences.

Le skill le plus utile pour un site reste celui que vous écrivez : vos couleurs, vos polices et vos composants, dans un skill de charte appliqué à chaque nouvelle page. Un skill ne règle ni l’hébergement, ni les sauvegardes, ni la mise en ligne. Pour passer d’une maquette à un site que votre client modifie seul, voyez de la maquette Claude au site WordPress.

N’installez que des skills de source sûre. Un skill peut contenir des scripts et des instructions qui font agir Claude : Anthropic recommande de lire tous ses fichiers avant de l’activer, en particulier s’il va chercher du contenu sur Internet. Les « packs de skills » partagés dans les groupes d’entraide n’y échappent pas.

Avant votre prochaine session

• Repérez la tâche que vous avez expliquée à Claude trois fois ce mois-ci.
• Écrivez sa description avec vos mots : ce qu’elle fait, quand l’utiliser.
• Rangez les données (prix, exemples, coordonnées) dans des fichiers de référence.
• Testez dans une conversation neuve, sans citer le skill, puis avec un cas incomplet.
• Corrigez une règle à la fois, et testez de nouveau.
• Relisez chaque sortie avant de l’envoyer : le skill ne valide rien à votre place.

Pour choisir le modèle selon la tâche, la page choisir son modèle IA et organiser plusieurs agents donne une méthode de test, et l’IA par métier propose des exemples pour votre profession.

Ce qu’un skill ne fait pas seul

Un skill est une procédure, il n’a pas de déclencheur à lui. Il s’applique quand une conversation ou une tâche le demande : la vôtre, ou une tâche planifiée que vous avez programmée dans Claude Cowork, qui tourne à l’heure fixée.

Pour qu’un événement lance le travail, un avis publié à 22 h sur votre fiche Google ou un vocal enregistré en sortant d’un chantier, il faut un branchement : un outil qui repère l’événement et transmet la demande, comme un flux n8n ou une routine de Claude Code (en aperçu de recherche) lancée par un autre logiciel. Le guide créer un agent IA sans coder montre un flux n8n. Ce branchement se configure et se surveille ; sans lui, l’avis attend que vous ouvriez Claude.

Si vous préférez déléguer la réception elle-même, il faut un assistant qui reçoit vos messages et connaît votre façon de travailler. C’est le rôle de l’assistant IA de MACCUS : un assistant installé et hébergé pour vous, que vous utilisez dans Telegram. Vous lui envoyez un vocal après une visite, il prépare le devis dans votre format pour que vous le relisiez. La connexion à votre messagerie ou à votre logiciel se décide avec vous, au cas par cas.