Claude Skills : créer, installer et 4 exemples en agence

Claude Skills désigne les compétences de Claude, des dossiers d’instructions bâtis autour d’un fichier SKILL.md, que Claude charge de lui-même quand votre demande correspond à leur description. Au 28 septembre 2026, elles fonctionnent sur toutes les formules de Claude.ai, gratuite comprise, dès que l’exécution de code est activée, ainsi que dans Claude Code et dans l’API. La consigne que vous recopiez chaque semaine, celle du compte rendu de visite par exemple, s’écrit une fois dans une skill et s’applique ensuite à chaque visite.

Définition, formules, installation, écriture du SKILL.md, sécurité, puis quatre skills à construire en agence : ce mode d’emploi complète le guide de l’IA en agence immobilière.

Claude Skills, c’est quoi exactement ?

Une skill, appelée « compétence » dans l’interface française, est un dossier qui contient des instructions, et au besoin des scripts et des ressources, que Claude charge dynamiquement pour mener une tâche précise de façon reproductible. Le centre d’aide d’Anthropic cite des documents conformes à une charte de marque ou des e-mails qui suivent les modèles de l’entreprise. Le cœur du dossier est le fichier SKILL.md : un en-tête en YAML, encadré par deux lignes de trois tirets, donne le nom (name) et la description (description), puis le corps, en Markdown, déroule la procédure.

La description commande le déclenchement : Claude compare votre demande à la description de chaque skill installée et ne lit la suite que si elle correspond. La documentation Agent Skills d’Anthropic appelle ce mécanisme la divulgation progressive, en trois niveaux :

1. Les métadonnées, toujours chargées. Nom et description occupent environ 100 jetons par skill, le jeton étant une fraction de mot : vous pouvez en installer beaucoup sans encombrer la conversation.
2. Les instructions, chargées au déclenchement. Le corps du SKILL.md, moins de 5 000 jetons selon la documentation, entre alors dans le contexte.
3. Les ressources et les scripts, lus à la demande. Un modèle ou un barème ne coûte rien tant que Claude ne l’ouvre pas ; d’un script exécuté, seul le résultat entre dans le contexte.

Le centre d’aide distingue quatre familles : les skills d’Anthropic, pour les fichiers Excel, Word, PowerPoint et PDF ; les skills personnalisées, écrites par vous ; les skills fournies par l’organisation en Team et Enterprise ; les skills de partenaires comme Notion, Figma ou Atlassian, conçues pour leurs connecteurs.

Trois dates situent la fonction. Anthropic l’a lancée le 16 octobre 2025, dans ses applications, Claude Code et l’API. Le 18 décembre 2025, elle a ajouté la gestion à l’échelle de l’organisation, un répertoire de skills de partenaires et la publication du format comme norme ouverte, Agent Skills, sur agentskills.io. Le 19 août 2026, Agent Skills et le point d’accès /v1/skills sont sortis de bêta dans l’API. Les autres usages de Claude en agence, de l’annonce au compromis, sont réunis dans notre guide de tous les usages de Claude pour un agent immobilier.

Quelle différence entre une skill, un projet et un connecteur MCP ?

Le projet garde un contexte toujours chargé dans un espace de travail, le connecteur (protocole MCP) donne à Claude l’accès à un service extérieur, les instructions personnalisées valent pour toutes vos conversations, et la skill apporte une procédure qui ne se charge que lorsque la tâche la demande, dans n’importe quelle conversation. Le tableau traduit cette grille du centre d’aide pour une agence.

Ces outils se combinent : le connecteur Gmail lit le message d’un acquéreur, la skill dit comment y répondre. Une skill ne peut pas faire explicitement référence à une autre, précise le centre d’aide, mais Claude en emploie plusieurs dans la même tâche. Voyez comment brancher Gmail, Outlook ou Drive à Claude, et rappelez-vous que le corps d’une skill obéit à la structure d’un prompt qui donne un texte exploitable : contexte, résultat attendu, format, éléments fournis.

Les skills Claude sont-elles gratuites, et sur quelle formule ?

Oui : au 28 septembre 2026, les skills sont ouvertes aux formules Free, Pro, Max, Team et Enterprise, à condition d’activer l’exécution de code et la création de fichiers, selon les articles du centre d’aide d’Anthropic mis à jour le 22 septembre 2026. Les formules se distinguent par le partage et par les outils qui accompagnent la skill.

En Team, et en Enterprise sans préférence définie, l’interrupteur « Partage de compétences » est activé par défaut, mais le bouton « Partager » n’apparaît qu’une fois qu’un propriétaire a activé l’un des réglages de partage dans « Paramètres de l’organisation > Plugins et compétences », onglet « Politique ». Une skill partagée reste en lecture seule pour ses destinataires, qui reçoivent vos mises à jour à la prochaine utilisation ; publiée, elle passe sous la gestion de l’organisation. Dans les configurations réglementées, comme la conformité HIPAA, skills et partage sont désactivés par défaut.

Les tarifs figurent sur la page des offres d’Anthropic. Deux pages d’Anthropic, la vue d’ensemble Agent Skills de la plateforme et le README du dépôt d’exemples, ne mentionnent encore que les offres payantes, et la première cite un menu « Settings > Features » ; pour Claude.ai, le centre d’aide du 22 septembre 2026 fait foi.

Comment installer une skill dans Claude ?

Pour installer une skill dans Claude, activez l’exécution de code dans « Paramètres > Capacités », puis ouvrez « Personnaliser > Compétences » pour allumer les skills d’Anthropic ou importer la vôtre en fichier ZIP. Les libellés suivent le centre d’aide :

1. Activer l’exécution de code. En Free, Pro et Max, dans « Paramètres > Capacités », activez l’exécution de code et la création de fichiers. En Team et Enterprise, le propriétaire vérifie dans « Paramètres de l’organisation > Plugins et compétences », onglet « Politique », que l’exécution de code et les compétences sont activées.
2. Ouvrir « Personnaliser > Compétences ». La liste montre chaque skill, sa date d’activation ou d’import et une brève description.
3. Allumer une skill d’Anthropic par son interrupteur : Claude s’en sert ensuite sans que vous la nommiez.
4. Importer votre skill. Cliquez sur « + », puis « + Créer une compétence », choisissez « Télécharger une compétence » et déposez le ZIP.
5. Tester avec plusieurs demandes ordinaires, puis ouvrir le raisonnement de Claude : il y mentionne la lecture de la skill.

Si Claude ignore la skill, vérifiez l’interrupteur, précisez dans la description le moment où elle s’applique, ou nommez-la : « Utilisez ma skill de compte rendu de visite pour ces notes. » Pour démarrer sans rien écrire, notre dossier offert propose un pack de 100 skills immobilières prêtes à importer, classées en 12 domaines.

Comment créer une skill Claude, du fichier SKILL.md au ZIP ?

Pour créer une skill Claude, créez un dossier au nom de la skill, placez-y un fichier SKILL.md qui commence par un en-tête YAML avec name et description, écrivez vos consignes en Markdown, puis compressez le dossier lui-même en ZIP. Voici le fichier complet d’une skill de compte rendu de visite pour l’Agence Vantelle, agence fictive, à adapter à votre plan et à votre ton.

---
name: compte-rendu-visite
description: Rédige le compte rendu de visite adressé au vendeur à partir des notes du négociateur. À utiliser après une visite, dès que des notes de visite sont fournies ou qu’un compte rendu est demandé.
---

# Compte rendu de visite, Agence Vantelle

## Entrées attendues
- Les notes de visite, même en vrac
- Le bien : type, rue, prix affiché
- La date de la visite et le nombre de visiteurs
Si une entrée manque, demandez-la avant d’écrire.

## Plan
1. La visite : date, projet du visiteur en une ligne, état de son financement sans aucun chiffre
2. Les points appréciés
3. Les objections, avec les mots du visiteur quand ils sont notés
4. Notre lecture : l’effet de ces retours sur le prix et la présentation
5. La suite proposée : contre-visite, ajustement, nouvelles photos

## Ton
Vouvoiement, phrases courtes, quinze lignes au plus. Aucun superlatif, aucune promesse de vente ni de délai.

## Interdits
- Le nom, les coordonnées, les revenus, l’apport ou la banque du visiteur
- Toute information sur sa santé, sa vie familiale ou sa personne
- Tout fait absent des notes : écrivez « à confirmer »

## Exemple
Entrée : « T3 rue des Lilas, couple primo-accédant, prêt à l’étude. Aime la lumière et le balcon. Cuisine à refaire, prix jugé haut. »
Sortie : un compte rendu au plan ci-dessus, qui rapporte l’objection sur le prix sans la commenter.

## Envoi
Produisez un brouillon. Le négociateur relit et envoie lui-même.

Cinq règles rendent une skill valable à la fois sur Claude.ai, dans Claude Code et dans l’API :

1. Un nom portable. Minuscules, chiffres et tirets, 64 caractères au plus, sans tiret au début ni à la fin ni tirets doublés, identique au nom du dossier : c’est la règle de la spécification Agent Skills. L’API interdit en outre les mots réservés « claude » et « anthropic ». Claude.ai admet un nom plus libre, mais ce format est accepté partout.
2. Une description qui dit quoi et quand, à la troisième personne, comme le recommandent les bonnes pratiques d’Anthropic, en 200 caractères au plus pour Claude.ai. L’API et la spécification en acceptent 1 024 ; Claude Code coupe au-delà de 1 536 caractères dans sa liste de skills.
3. Un corps court, sous 500 lignes, les détails allant dans des fichiers de référence liés directement depuis SKILL.md, sur un seul niveau.
4. Aucune donnée sensible. Ni donnée client, ni mot de passe, ni clé d’accès ; pour ces deux derniers, le centre d’aide demande de ne jamais les écrire en dur.
5. Un ZIP dont la racine est le dossier : compte-rendu-visite.zip contient le dossier compte-rendu-visite, qui contient SKILL.md. Le centre d’aide qualifie d’incorrecte une archive dont les fichiers sont posés directement à sa racine.

Reste la casse du nom de fichier. La spécification, l’API et Claude Code écrivent SKILL.md, le centre d’aide de Claude.ai écrit skill.md, et les exemples d’Anthropic, en SKILL.md, renvoient à la même procédure d’import sur Claude.ai. Retenez SKILL.md, la forme qu’attend Claude Code.

Trois façons d’écrire une skill

• À la main, à partir du modèle ci-dessus ou du gabarit que fournit le dépôt github.com/anthropics/skills dans son dossier template.
• En conversation. Décrivez votre procédure à Claude : la skill skill-creator d’Anthropic lui sert à vous interroger, à créer l’arborescence, à rédiger le SKILL.md et à assembler les ressources, comme Anthropic l’a annoncé le 16 octobre 2025. Dans le chat, surlignez un passage du fichier et cliquez sur « Modifier avec Claude » pour le reprendre.
• Par enregistrement d’écran. « Enregistrer une compétence » fonctionne dans Cowork sur Claude pour Mac, en Pro, Max et Team : vous faites la tâche, en la commentant à voix haute si vous le voulez, environ 10 minutes au plus, et Claude propose une skill à relire. La vidéo et l’audio ne sont pas conservés ; des captures d’écran restent dans la tâche Cowork. Voyez comment enregistrer une skill en faisant la tâche devant Claude, et notre présentation de Cowork, l’espace où Claude travaille sur vos fichiers.

À l’Agence Vantelle, la directrice écrit la skill un lundi, la teste sur les notes de trois visites et resserre la description après un essai où Claude ne l’avait pas déclenchée. L’agence étant en Team, elle la partage avec ses deux négociateurs, qui l’activent sans pouvoir la modifier.

Comment utiliser les skills dans Claude Code, Cowork ou l’API ?

Les skills s’utilisent sur le site et les applications de Claude, dans Cowork, dans les compléments Excel, PowerPoint, Word et Outlook, dans Claude Code et dans l’API, chaque surface ayant son mode d’installation et de partage.

L’accès au réseau varie : complet, partiel ou nul sur Claude.ai selon les réglages, nul dans l’API, celui de votre ordinateur dans Claude Code.

Claude Code : les skills dans le terminal

Dans Claude Code, une skill est un dossier posé dans ~/.claude/skills/ pour tous vos projets, ou dans .claude/skills/ d’un projet, partagé avec l’équipe par le dépôt. Claude l’emploie de lui-même ou vous l’appelez par /nom-de-la-skill ; le champ disable-model-invocation, réglé sur true, la réserve à cet appel manuel. Depuis septembre 2026, les skills activées sur votre compte Claude.ai se synchronisent dans les sessions du terminal connectées au même compte, au démarrage puis environ toutes les dix minutes, sans rien modifier sur le compte. La synchronisation ne fonctionne pas avec une clé d’API ni chez un fournisseur cloud comme Amazon Bedrock, et le réglage syncClaudeAiSkills, mis à false, la coupe.

L’API : les skills dans vos applications

Dans l’API, une skill s’importe par /v1/skills, en moins de 30 Mo une fois décompressée, puis se charge par le paramètre container avec l’outil d’exécution de code ; les skills d’Anthropic s’y appellent pptx, xlsx, docx et pdf. Elle s’exécute dans un conteneur sans accès au réseau ni installation de paquets, et Agent Skills n’entre pas dans les accords de conservation zéro des données. Une skill de Claude.ai s’importe de nouveau dans l’API.

Le même dossier sert hors de Claude : agentskills.io liste les outils qui adoptent la norme, et GitHub a annoncé le 18 décembre 2025 que Copilot lit les skills, y compris celles du dossier .claude/skills d’un dépôt.

Quelles skills créer pour une agence immobilière ? 4 exemples

Commencez par les écrits que l’agence produit chaque semaine selon un modèle stable : l’annonce, le compte rendu de visite, l’avis de valeur et la relance d’acquéreur. Ces quatre skills sont des modèles à écrire par l’agence ; chaque description tient en moins de 200 caractères, et chaque skill rend un brouillon que l’agent relit.

1. L’annonce de bien

• Description proposée : « Rédige l’annonce d’un bien à partir de sa fiche descriptive et de son DPE, en version portail et version courte, et signale chaque mention obligatoire manquante. »
• Entrées : la fiche descriptive qui nourrit l’annonce, le DPE, le prix et la partie qui paie les honoraires.
• Sortie : un titre, le texte du portail, trois points forts, une version courte pour les réseaux sociaux, la liste des mentions à compléter.
• Garde-fou : la skill contrôle d’abord le prix, la partie qui paie les honoraires et, si l’acquéreur en paie une part, leur taux toutes taxes comprises (article 3 de l’arrêté du 10 janvier 2017), les classes énergie et climat et, pour un logement, le montant estimé des dépenses annuelles d’énergie (article L. 126-33 du code de la construction et de l’habitation), puis, selon le bien, les mentions de copropriété et la phrase Géorisques sur les risques. Une donnée absente devient « à compléter » : la skill n’invente aucune caractéristique. Le détail figure dans la liste des mentions obligatoires d’une annonce.

2. Le compte rendu de visite

• Description proposée : celle du fichier complet ci-dessus, qui nomme la tâche et son déclencheur.
• Entrées : les notes dictées en sortant du bien, le bien, la date.
• Sortie : un brouillon de quinze lignes au plus, au plan fixe de l’agence, que le négociateur envoie au vendeur.
• Garde-fou : le principe de minimisation du RGPD (article 5, paragraphe 1, point c, du règlement (UE) 2016/679) et l’article 7 du code de déontologie des professionnels de l’immobilier, qui impose prudence et discrétion sur les données des tiers, écartent le nom du visiteur, ses coordonnées, ses revenus et son apport. Le contenu attendu figure dans le modèle de compte rendu de visite.

3. L’avis de valeur

• Description proposée : « Prépare un avis de valeur à partir des comparables fournis par l’agent, en fourchette argumentée, avec la mention qu’il ne constitue pas une expertise. À utiliser avant un rendez-vous d’estimation. »
• Entrées : la description du bien après visite et les comparables retenus par l’agent, en séparant ventes de l’agence, ventes publiées dans la base DVF et annonces en cours.
• Sortie : un tableau des comparables, la fourchette justifiée, les éléments qui jouent à la hausse et à la baisse, les réserves.
• Garde-fou : l’article 6 (4°) du code de déontologie oblige à informer le client que l’avis de valeur ne constitue pas une expertise. La skill écrit cette mention, n’ajoute aucun comparable de sa propre initiative et laisse le prix à l’agent. Voyez le modèle d’avis de valeur et la responsabilité qu’il engage.

4. La relance d’acquéreur après visite

• Description proposée : « Rédige l’e-mail de relance d’un acquéreur après la visite d’un bien, au ton de l’agence, à partir du compte rendu et de ses questions. Produit un brouillon que l’agent relit et envoie. »
• Entrées : le compte rendu de visite, les questions de l’acquéreur, les documents promis.
• Sortie : un e-mail de dix lignes au plus, avec remerciement, réponses, documents joints et proposition de contre-visite.
• Garde-fou : le brouillon porte sur le bien visité et la suite de cette visite ; la skill n’y propose aucun autre bien. Proposer d’autres biens par courriel à un acquéreur qui n’a signé qu’un bon de visite suppose son consentement préalable (article L. 34-5 du code des postes et des communications électroniques). Par téléphone, depuis le 11 août 2026, l’article L. 223-1 du code de la consommation, réécrit par l’article 13 de la loi n° 2025-594 du 30 juin 2025, exige aussi ce consentement, sauf appel en rapport avec l’objet d’un contrat en cours, et met sa preuve à la charge du professionnel ; le décret n° 2026-662 du 23 juillet 2026 fixe les modalités de son recueil. L’acquéreur sous mandat de recherche peut être appelé sur l’objet de ce mandat. La skill signale ces règles à l’agent, hors du texte destiné à l’acquéreur. Pour le ton, voyez comment écrire ses mails d’agent immobilier avec l’IA.

Quand la skill ne suffit plus

Une skill s’applique quand une demande correspond à sa description : la vôtre, dans une conversation, ou celle d’une tâche programmée dans Cowork, qui charge les skills de votre compte et se lance à l’heure prévue, sur les formules payantes. Un travail qui doit lire et écrire dans le logiciel de transaction et servir toute l’équipe avec le même suivi relève de l’agent IA : notre article détaille les étapes pour créer un agent IA en agence. Kappn Agency construit un dashboard d’agents IA relié à votre CRM et à vos boîtes mail, un agent par tâche ; vous pouvez d’abord composer vos agents IA en quelques questions.

Peut-on installer une skill trouvée sur GitHub ou une marketplace ?

Oui, une skill publiée en ZIP s’importe comme la vôtre, mais Anthropic demande de n’installer que des skills de sources de confiance et d’en lire chaque fichier avant de l’activer, car une skill peut faire exécuter du code. Le centre d’aide nomme deux risques principaux, l’injection de consignes et l’exfiltration de données, et demande la même relecture pour une skill partagée par un collègue.

Le dépôt github.com/anthropics/skills publie les exemples d’Anthropic ; dans Claude Code, la commande /plugin marketplace add anthropics/skills l’ajoute comme place de marché de plugins. Pour lui comme pour les annuaires tiers, six contrôles :

1. Lire SKILL.md et chaque script en entier avant l’activation.
2. Repérer les appels réseau et les dépendances : une adresse externe ou un paquet sans rapport avec la tâche fait écarter la skill.
3. Vérifier la licence. Une partie du dépôt d’Anthropic est sous licence Apache 2.0 ; les skills docx, pdf, pptx et xlsx y sont en code source consultable, sans licence libre.
4. Retirer toute donnée client des exemples et des fichiers de référence.
5. Tester sur un dossier fictif, avec des noms et des adresses inventés.
6. En Enterprise, activer l’analyse des skills : chaque skill tierce importée ou modifiée est vérifiée avant de pouvoir s’exécuter, en une à deux minutes le plus souvent.

Les données de clients n’ont pas leur place dans une skill : elles arrivent dans la conversation, au moment de la tâche, et relèvent du RGPD. Voyez les données clients à ne jamais confier à une IA.

Florian Berthoud

Fondateur de Kappn Agency · 10 ans dans l’immobilier de luxe à Paris