Guide d'Entreprise Claude - Modèles, Gabarits et Gouvernance

Les compétences Claude (Skills) sont des dossiers regroupant instructions, ressources et (au besoin) scripts pour permettre à Claude d'exécuter des flux de travail répétables sur demande. Utilisez les compétences pour uniformiser vos invites, intégrer vos règles d'affaires et connecter vos outils — pour ensuite les tester, les versionner et les partager facilement entre vos équipes. Ce guide résume les dernières recommandations d'Anthropic en un plan d'action pragmatique, parfaitement adapté aux réalités de l'entreprise.

Pourquoi ce guide?

Le nouveau guide d'Anthropic clarifie la manière de structurer, tester et déployer les compétences — notamment leur intégration avec MCP et l'API. Nous avons traduit tout cela en étapes concrètes, modèles et règles de gouvernance pour que vos équipes gagnent en constance, sans créer de chaos.

Qu'est-ce qu'une compétence Claude (Skill)?

Une compétence est un petit paquet versionné (un dossier) que Claude peut repérer et charger. Au minimum, elle comprend :

• SKILL.md — les instructions officielles régissant le comportement et l'utilisation.

• Des ressources optionnelles — exemples, schémas, extraits d'invites, documents de référence.

• Des outils ou scripts optionnels — appelés de manière sécurisée par exécution de code ou via API.

Voyez les compétences comme des guides pratiques réutilisables que Claude peut suivre à la lettre, plutôt que de simples invites perdues au fil des conversations.

Anatomie d'une compétence (modèle)

Modèle de départ SKILL.md

Façons de procéder (choisissez votre voie)

1. Application Claude (sans code) — Activez les Skills dans Paramètres → Capacités. Utilisez le Skill Creator pour structurer, tester avec des exemples d'entrées, puis déployer auprès de votre équipe ou espace de travail.

2. API — Intégrez les compétences avec l'API Claude; laissez l'exécution de code active pour les compétences qui utilisent des scripts; gérez vos versions avec Git et votre pipeline CI.

3. MCP + Compétences — Combinez des connecteurs d'outils universels (MCP) avec la structure des compétences pour le contexte et le comportement. Considérez MCP comme la tuyauterie et les compétences comme le plan de match.

Cinq modèles de compétences prêts pour l'entreprise

1. Vérificateur de définition des KPI
   Quand l'utiliser : lorsque les chiffres varient d'une équipe à l'autre.
   Entrées : nom de la métrique, période couverte.
   Sortie : définition, extrait SQL/logique, responsable, fraîcheur des données, mises en garde.
   Garde-fou : bloquer si la fraîcheur de la source dépasse le seuil; exiger des liens vers les sources.

2. Réponses aux appels d'offres et sécurité
   Quand l'utiliser : pour les questionnaires répétitifs.
   Entrées : libellé de la question, secteur de produit, niveau de sensibilité.
   Sortie : ébauche de réponse + sources vers des contenus approuvés.
   Garde-fou : étiqueter comme [ÉBAUCHE-IA]; faire réviser par un humain avant l'envoi externe.

3. Réunions → Décisions → Actions
   Quand l'utiliser : pour éviter que les conclusions ne se perdent.
   Entrées : notes ou transcription, identifiant du projet.
   Sortie : liste des décisions, tâches à accomplir (responsable, échéance).
   Garde-fou : ne jamais assigner à l'externe; exiger une confirmation humaine.

4. Triage de la qualité des données
   Quand l'utiliser : lorsque le volume d'incidents submerge les équipes de données.
   Entrées : liste des tests échoués, traçabilité des jeux de données.
   Sortie : triage par priorité avec causes fondamentales suspectées et responsables.
   Garde-fou : lecture seule; renvoyer vers les manuels opérationnels (runbooks); aucune opération destructive.

5. Soutien aux ventes (Sales Enablement)
   Quand l'utiliser : quand l'équipe des ventes doit constamment réexpliquer les aspects techniques.
   Entrées : question, secteur d'activité, gamme de produit.
   Sortie : réponse claire d'environ 200 mots + ébauche optionnelle d'un artéfact (diapositive).
   Garde-fou : mots interdits pour les prix et les aspects juridiques; transfert obligatoire vers un spécialiste.

Les tests : rendre vos compétences fiables

• Tests de référence (Golden tests) : placez de vraies données d'entrée dans /tests avec les sorties attendues. Lancez-les après chaque modification.

• Tests de mutation : testez la robustesse avec des entrées imprévues (fautes de frappe, champs manquants) pour vérifier que le système échoue de manière sécuritaire.

• Portes de régression : bloquez la publication si un test échoue ou si les sorties omettent des champs obligatoires ou des sources.

• Révision humaine : exigez l'approbation d'au moins un responsable du domaine pour tout niveau de risque égal ou supérieur à Moyen.

Gestion des versions et distribution

• Versions sémantiques (1.2.0), journal des modifications dans SKILL.md.

• Responsables principaux et substituts dans skill.config.json.

• Canaux de publication : Équipe, Espace de travail, Organisation. Commencez à petite échelle avant d'élargir.

• Politique de retrait : avertissement automatique dans la description de la compétence et date de fin de vie.

Gouvernance et gestion des risques

• Minimisation des données : évitez d'inclure des renseignements personnels identifiables (PII) dans les entrées, sauf si approuvé par vos politiques.

• Provenance : exigez des citations vers des sources approuvées pour toutes les affirmations factuelles.

• Sécurité d'exécution : limitez les scripts à des utilitaires (mise en forme, validation). Aucune écriture externe sans autorisation explicite.

• Observabilité : centralisez les journaux d'utilisation, les erreurs et les interventions manuelles sur un tableau de bord.

• Droits d'utilisation : assurez-vous que tout contenu intégré est autorisé pour un usage à l'interne.

Invites prêtes à l'emploi

Cahier des charges pour la création

« Tu es un architecte de compétences. Crée le fichier SKILL.md pour {compétence}. Définis précisément les entrées et les sorties, énumère les garde-fous et propose 5 exemples complets avec les sorties attendues. »

Générateur de tests

« À partir de ce fichier SKILL.md, génère des tests de référence pour les cas d'utilisation courants et limites sous forme d'enregistrements JSON à enregistrer dans /tests. »

Évaluation des risques

« Analyse cette compétence selon notre politique interne. Signale les risques liés aux renseignements personnels, aux appels externes et aux points de transfert vers un humain. Propose des garde-fous et des refus par défaut. »

Exemple : SKILL.md pour « Vérificateur de définition des KPI »

Plan de déploiement (14 jours)

Jours 1 et 2 : choisir trois compétences (risque faible/moyen) et leurs responsables.
Jours 3 à 5 : rédiger le fichier SKILL.md et les ressources; structurer le tout avec Skill Creator.
Jours 6 et 7 : écrire les tests de référence et de mutation.
Jours 8 à 10 : lancer un projet pilote avec 10 utilisateurs; noter les irritants.
Jours 11 et 12 : intégrer les garde-fous finaux et passer à la version 1.0.0.
Jours 13 et 14 : déployer dans le canal d'équipe; mettre en place un tableau de bord d'utilisation simple.

Foire aux questions

Les compétences sont-elles accessibles avec tous les forfaits?
Oui! Les compétences sont offertes à grande échelle dans Claude (avec l'exécution de code activée); les utilisateurs de l'API peuvent les configurer en suivant la documentation de la plateforme. Vérifiez les paramètres de gestion de votre forfait Entreprise.

Quelle est la différence entre Compétences, MCP et Artéfacts?

• Les compétences (Skills) regroupent le comportement et les ressources.

• MCP fournit les connecteurs d'outils (la tuyauterie).

• Les artéfacts sont les résultats produits que vous pouvez ouvrir et modifier (documents, applications). Utilisez les compétences pour générer des artéfacts cohérents.

Comment éviter les dérives?
Conservez vos compétences dans Git, avec des responsables désignés et des tests automatisés. Considérez SKILL.md comme une mini-spécification : chaque modification doit être révisée.

Les compétences peuvent-elles interagir avec des systèmes externes?
Uniquement via des connecteurs approuvés et en respectant vos garde-fous; privilégiez les accès en lecture seule et exigez une validation humaine pour toute écriture.

Prochaines étapes

Vous aimeriez un ensemble de départ adapté à votre organisation?
Nous pouvons vous aider à concevoir trois compétences prêtes pour la production avec tests et garde-fous, les brancher à vos outils actuels et former votre équipe pour qu'elle puisse les faire évoluer en toute autonomie.