Construire un Claude Skill pour automatiser un workflow métier en 30 minutes.

Pourquoi un skill ?

Un skill, c'est un prompt qui marche, transformé en fonction réutilisable. Vous l'avez peut-être affiné pendant trois semaines pour produire un mémo de variance qui passe le filtre de votre CFO. Sans skill, ce prompt vit dans une note Apple, dans le tab Slack d'un collègue, dans un Notion à demi-rangé. Avec un skill, il devient une capacité native de Claude — invocable par tous, versionnable, mesurable. Le skill est l'unité de capitalisation de l'agent.

Anatomie d'un Claude Skill

Un skill = trois fichiers, parfois quatre. Le cœur est un fichier SKILL.md qui décrit le contrat (nom, description, triggers). Autour, vous ajoutez un system prompt, des outils si la skill en a besoin (lecture CRM, écriture DOCX), et des scripts si elle doit appeler du code déterministe.

my-skill/
  SKILL.md          ← contrat + frontmatter (nom, description, triggers)
  system.md         ← règles du jeu (ton, contraintes, format)
  tools/
    fetch_crm.ts    ← appel API CRM
    render_docx.ts  ← rendu template DOCX
  scripts/
    score.py        ← scoring déterministe

Claude charge le SKILL.md en lazy-load : seulement quand le contexte de la conversation matche les triggers. Vous pouvez donc avoir 200 skills installés sans alourdir le prompt de chaque tour.

Notre exemple : memo-variance

Le cas d'usage : un contrôleur de gestion produit chaque mois 14 mémos de variance pour son comité de direction. Chaque mémo prend 35 minutes : ouvrir le rapport BI, comparer N et N-1, identifier les écarts > 5 %, rédiger la narrative, justifier les écarts avec les opérations, formater au gabarit DOCX maison. Total : 8 h de travail à faible valeur ajoutée par mois.

Notre skill memo-variance ramène ça à 6 minutes : extraction des chiffres CRM via tool, comparaison automatique, narrative générée avec ton interne, output DOCX prêt à signer. Le contrôleur relit, ajuste deux phrases, envoie.

Étape 1 : Le SKILL.md

Le frontmatter YAML décrit ce que la skill fait et quand elle se déclenche. Soyez précis sur les triggers : un trigger trop large pollue le contexte, un trigger trop étroit empêche Claude de découvrir la skill quand elle serait utile.

---
name: memo-variance
description: Génère un mémo de variance mensuel à partir d'un rapport CRM
  brut. Compare période courante vs N-1, identifie les écarts > 5 %, rédige
  la narrative au format DOCX avec gabarit Waimia.
triggers:
  - "rapport de variance"
  - "mémo mensuel finance"
  - "écart budget réel"
  - "comparaison N-1"
tools:
  - fetch_crm
  - render_docx
---

# Memo Variance Skill

Cette skill produit un mémo de variance financière à partir d'un rapport
mensuel brut.

Étape 2 : System prompt

Le system prompt encode les règles du jeu : ton, format attendu, contraintes éditoriales, garde-fous. Pour memo-variance, on précise quatre choses essentielles.

• Ton : factuel, pas commercial. Pas de superlatifs (« remarquable », « exceptionnel »).
• Format : 4 sections fixes — Synthèse, Écarts > 5 %, Causes opérationnelles, Recommandations.
• Chiffres : toujours en valeur absolue ET en pourcentage. Toujours arrondi à 2 décimales.
• Garde-fou : si un écart dépasse 25 %, le marquer en rouge et exiger une vérification humaine avant publication.

Ce prompt système, c'est le savoir-faire interne du contrôleur écrit. Aucun modèle ne le devine. C'est ce qui transforme une output générique en livrable signable.

Étape 3 : Tools associés

Deux outils suffisent. fetch_crm récupère les chiffres bruts depuis HubSpot ou Salesforce via une API authentifiée. render_docx applique le gabarit DOCX maison (logo, polices, structure de mémo) au texte généré.

// tools/fetch_crm.ts
export const fetchCrm = {
  name: 'fetch_crm',
  description: 'Récupère les chiffres N et N-1 par ligne de revenu',
  input_schema: {
    type: 'object',
    properties: {
      period: { type: 'string', description: 'Format YYYY-MM' },
      segment: { type: 'string', description: 'enterprise | mid-market | smb' }
    },
    required: ['period']
  },
  execute: async ({ period, segment }) => {
    // appel HubSpot avec scope read-only
    const data = await hubspot.reports.fetch({ period, segment });
    return { current: data.current, previous: data.previous };
  }
};

La règle d'or : les tools donnent à Claude des capacités déterministes. La narrative est générative, les chiffres ne le sont jamais. Si un chiffre est inventé, votre skill est morte avant le premier comité.

Étape 4 : Test et itération

Une skill ne naît pas parfaite. Le travail réel commence après le déploiement. Sur memo-variance, on a fait tourner la skill sur les 12 derniers mémos de variance produits manuellement. On a comparé chaque output Claude à la version humaine validée. Le scoring se fait sur trois axes :

• Exactitude : tous les chiffres correspondent-ils au rapport source ? (zéro tolérance)
• Couverture : tous les écarts > 5 % sont-ils mentionnés ? (zéro oubli)
• Ton : la narrative passerait-elle le filtre du CFO sans réécriture lourde ? (note 1-5)

Sur les 4 premiers tests, on a corrigé : un format de date, deux phrases trop commerciales dans le system prompt, un cas limite où le rapport source contient des cellules vides. À partir du 8e test, le scoring passe au-dessus de 4.5/5 et la skill est prête.

Une skill mature a son propre changelog. Versionnez-la dans votre repo, taggez chaque release, gardez les anciennes versions accessibles. C'est de l'ingénierie logicielle classique appliquée à du prompt — et c'est ce qui distingue un skill jouable d'un POC.

Aller plus loin

Quand votre skill a besoin d'accéder à un outil externe (Notion, Drive, Slack, votre CRM maison), passez par un serveur MCP — c'est l'API standard d'Anthropic. Le cookbook 02 détaille comment câbler un serveur MCP Notion en moins d'une heure.

Quand vous voulez déployer 50 skills sur 200 collaborateurs, le cookbook 03 donne la checklist d'adoption qui distingue 80 % d'usage actif de 73 % de licences inutilisées.

Et si vous voulez nous confier la construction d'une bibliothèque de skills sur mesure pour vos métiers, notre offre Conseil Claude Cowork couvre l'audit, la priorisation et la livraison sur 6 semaines.