Skills Claude Code : créer SKILL.md et sa bibliothèque

Documentation Ailoot : API, clés et configuration.

Qu’est-ce qu’un skill dans Claude Code, et pourquoi ce n’est pas simplement « un prompt plus long » ?#

Les Claude Code Skills sont une fonctionnalité native de Claude Code lancée par Anthropic en octobre 2025 pour les offres Pro/Max/Team/Enterprise. Par la suite, Anthropic a publié la spécification Agent Skills comme standard utilisable au-delà de Claude. Dans le code, il s’agit simplement d’un dossier :

.claude/skills/
├── deploy-to-prod/
│   ├── SKILL.md
│   └── scripts/
│       └── check-migrations.sh
├── weekly-content-plan/
│   └── SKILL.md
└── triage-support-tickets/
    └── SKILL.md

Chaque dossier correspond à un skill. Le fichier SKILL.md est un document Markdown avec des métadonnées YAML en tête et des instructions ordinaires en dessous. Quand un utilisateur dit « déployons en production », Claude voit la description du skill deploy-to-prod, reconnaît le déclencheur « déployer en production », charge le contenu de SKILL.md dans son contexte et suit les étapes.

Trois niveaux de chargement progressif

Anthropic a conçu les skills avec un chargement progressif : les données sont chargées par couches selon les besoins. Dans le blog Anthropic Engineering, l’équipe le décrit comme le « principe de conception fondamental qui rend Agent Skills flexible et évolutif » (Anthropic Engineering).

Les trois niveaux de chargement :

1. Métadonnées (toujours) – Au début d’une session, Claude ne voit que le name et la description de chaque skill. Budget : environ 100 tokens par skill.
2. Instructions (au déclenchement) – Quand l’utilisateur dit quelque chose de pertinent, Claude charge le contenu de SKILL.md. Budget : moins de 5000 tokens.
3. Ressources (sur demande) – Les fichiers fournis (exemples, modèles, jeux de données) ne sont récupérés que lorsque le modèle les recherche lui-même. Budget : illimité.

Auparavant, CLAUDE.md devait contenir tout ce que l’IA devait « retenir » — et un projet avec 50 règles atteignait rapidement la limite de contexte. Avec les skills, des dizaines peuvent facilement coexister dans un projet, car seules leurs descriptions entrent dans le contexte initial.

Où placer les skills : quatre niveaux

Priorité : Enterprise remplace les paramètres personnels, qui remplacent ceux du projet. Les plugins utilisent l’espace de noms plugin-name:skill-name et n’entrent pas en conflit. C’est pratique : placez les skills professionnels généraux dans ~/.claude/skills/ et ceux propres à un projet dans le dossier .claude/skills/ du dépôt.

Que contient un SKILL.md ?#

Voici un exemple minimal — vingt lignes, et le skill est prêt :

---
name: weekly-content-plan
description: Prepares a weekly post plan for a Telegram channel and short-form video posts. Triggers - "make a post plan", "what should I post this week", "a 7-day channel plan". Do not activate if the request is about a website or email newsletter.
---

# Weekly Content Plan

## Steps

1. Read `knowledge/audience.md` - who we're writing for
2. Read `knowledge/tone-of-voice.md` - how we write
3. Read the last 10 posts in the channel - what has already been covered
4. Come up with 7 topics for the week: 3 sales-focused, 2 expert, 2 personal
5. For each, provide one hook line and three bullets about the post
6. Output as a table: day of the week | type | hook | plan

Ça suffit. Si un utilisateur écrit « planifions les publications de la semaine », Claude repère le déclencheur dans la description, charge SKILL.md, lit les fichiers indiqués et produit un tableau.

Limites à garder à l’esprit

La documentation officielle de l’API Claude fixe des limites strictes :

• name : jusqu’à 64 caractères, uniquement des minuscules, des chiffres et des tirets, sans balises XML. anthropic et claude sont réservés.
• description : jusqu’à 1024 caractères dans l’API ; obligatoire, sans balises XML.
• Budget de liste : dans Claude Code, les descriptions de tous les skills occupent ensemble environ 1 % de la fenêtre de contexte. S’il y a beaucoup de skills, les descriptions seront tronquées et les mots-clés nécessaires à Claude pour les associer risquent de disparaître.
• Corps de SKILL.md : Anthropic recommande de le limiter à 500 lignes. Déplacez les éléments plus longs dans des fichiers sous references/, scripts/ et examples/, puis chargez-les à l’aide des instructions.

Après la compaction du contexte (/compact), Claude conserve les 5000 premiers tokens de chaque skill précédemment invoqué ; le budget total pour tous les skills rattachés est de 25 000 tokens. Si un skill ne tient pas, son comportement est « oublié ».

Schéma complet des métadonnées

Utilisez au minimum name et description. Les skills de production utilisent aussi d’autres champs :

Le champ disable-model-invocation: true est indispensable pour tout ce qui ne doit pas s’exécuter automatiquement. Par exemple, un skill deploy-to-prod doté de ce champ ne peut être invoqué que si l’utilisateur saisit explicitement /deploy-to-prod. Sans ce champ, Claude pourrait déployer parce que « le code semble prêt ».

Pourquoi la description représente-t-elle 90 % du travail, et comment en rédiger une ?#

L’erreur la plus courante des vibe-codeurs consiste à rédiger une description comme « Assistant pour X ». Le skill est bien présent dans son dossier, mais Claude ne l’invoque pas.

Une mauvaise description

description: Build dashboards.

Ce que Claude ne peut pas déterminer : quand l’utilisateur demande « montre-moi les ventes de la semaine », est-ce lié à un tableau de bord ou non ? Quand il demande un « graphique des revenus », parle-t-il d’un tableau de bord ou seulement d’un graphique en général ? Quand il demande un « rapport mensuel », est-ce forcément sans rapport avec un tableau de bord ?

Le skill-creator d’Anthropic formule directement cette recommandation :

La formule d’une bonne description

Trois éléments :

1. Ce que fait le skill – une phrase sur le résultat, pas sur le processus. Pas « génère du SQL », mais « exporte les ventes dans un tableau pour un canal Telegram ».
2. Quand le déclencher – 3 à 5 expressions entre guillemets que les utilisateurs disent réellement. Ne devinez pas : consultez l’historique de vos chats et de votre support.
3. Quand NE PAS le déclencher – 1 ou 2 expressions concernant des tâches similaires auxquelles le skill ne doit pas répondre. Sans cette section, deux skills similaires entreront sans cesse en conflit.

Voici un exemple de description efficace tiré de mon projet (simplifié et anonymisé) :

description: |
  Writes and publishes an SEO guide to the blog, following the editorial policy.
  Triggers: "write a guide about X", "let's make a new pillar",
  "a blog article about Y", "build a blog guide about Z".
  Do not activate if the request is about an email newsletter,
  a Telegram post, or an internal team instruction—
  those are other skills.

Ce qui fonctionne ici :

• Le verbe « écrit et publie » au lieu de « aide à » indique un résultat concret.
• Quatre expressions déclencheuses entre guillemets couvrent différentes formulations.
• Une expression déclencheuse en anglais est également incluse : si l’utilisateur passe à la langue de l’équipe, le skill fonctionnera aussi.
• Une section distincte « ne pas activer si » évite les conflits avec les skills dédiés aux e-mails et aux publications.

Comment tester une description

Dans son skill-creator, Anthropic a intégré une méthode d’évaluation des déclencheurs : 20 prompts permettent de vérifier si un skill s’active. Dix doivent le déclencher et dix ne doivent pas le faire, notamment dans des scénarios proches où la formulation est similaire, mais la tâche différente.

Pour un vibe-codeur, cela signifie qu’après avoir écrit la description, il faut ouvrir un chat vide et essayer 5 expressions que l’on utilise réellement, ainsi que 3 expressions similaires qui veulent dire autre chose. Si le skill ne s’active pas quand il le devrait, ou s’active alors qu’il ne le devrait pas, réécrivez la description. Ce n’est qu’ensuite qu’il faut rédiger le corps des instructions.

Quels 5 skills installerais-je en premier ?#

Passer les deux premières semaines à rédiger ses propres skills est une stratégie perdante. Commencez par en installer des prêts à l’emploi et observez comment ils sont conçus ; ajoutez ensuite les vôtres en suivant la même approche. Il est moins coûteux d’adopter des collections éprouvées créées par d’autres et de les adapter que de tout construire de zéro. Voici cinq collections que je recommande pour commencer :

1. anthropics/skills – collection officielle avec skill-creator

Dépôt : github.com/anthropics/skills. 138,000 étoiles sur GitHub. Il contient les skills officiels de l’équipe Anthropic : skill-creator (un méta-skill qui rédige d’autres skills), claude-api (qui aide à créer des intégrations API) et des skills documentaires prêts à l’emploi pour PowerPoint, Excel, Word et PDF.

Installation avec Claude Code :

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

La principale valeur ajoutée est skill-creator. Il rédige un SKILL.md à partir de votre description, lance ensuite 20 évaluations de déclencheurs et révise la description jusqu’à ce que le skill s’active dans les situations appropriées. En résumé, c’est « un skill pour créer des skills ».

2. mattpocock/skills – la collection virale d’un expert TypeScript

La collection comprend 12 skills actifs, dont :

• tdd – impose le cycle red-green-refactor : d’abord un test qui échoue, puis une correction minimale, puis le refactoring.
• to-issues – transforme un plan en issues GitHub découpées verticalement (full-stack et déployables indépendamment).

Installation :

npx skills@latest add mattpocock/skills
/setup-matt-pocock-skills

3. coreyhaines31/marketingskills – une collection pour les spécialistes du marketing

Si vous gérez des programmes en ligne, travaillez comme spécialiste du marketing indépendant ou dirigez une agence, vous n’avez pas besoin de passer six mois à rédiger vos propres skills. La moitié des tâches sont déjà prêtes à l’emploi.

4. vercel-labs/agent-skills – un design sans apparence d’IA

Dépôt : github.com/vercel-labs/agent-skills. Son skill phare est web-design-guidelines. Il vérifie le code UI au regard de plus de 100 règles d’accessibilité, de performance et d’ergonomie.

À côté, on trouve frontend-design d’Anthropic, avec plus de 110,000 installations par semaine. Ce skill fait choisir un style à l’IA avant qu’elle commence à écrire du code. Sans lui, chaque page générée par Claude utilise la police Inter, un dégradé violet et des cartes en grille. Tout le monde obtient le même résultat.

5. obra/superpowers – flux de travail multi-agents

En installant les trois premières collections de cette liste — anthropics/skills, mattpocock/skills et coreyhaines31/marketingskills — Claude Code disposera de dizaines de skills prêts à l’emploi couvrant la plupart des tâches d’un entrepreneur dès le premier mois.

Vous souhaitez non seulement installer des skills prêts à l’emploi, mais aussi créer une configuration qui fasse réellement de Claude votre assistant ? Les skills constituent l’un des trois piliers de la méthode. Une configuration opérationnelle comprend trois éléments : clone IA (les Skills comme expertise empaquetée) + Second Brain (une structure de connaissances pour le contexte) + Context Engineering (la façon dont Claude voit le projet dans son ensemble). Cette configuration transforme Claude, d’un assistant qui devine, en un outil qui raisonne selon votre logique.

Quelles tâches répétitives devriez-vous transformer en skill ?#

Dans le travail avec des clients et les projets d’autres personnes, j’ai vu ce schéma des dizaines de fois. Quelqu’un a « cette tâche qu’il recommence chaque fois de zéro ». Chaque lundi, il rédige le même type de rapport. Chaque fois qu’un nouveau client arrive, il suit la même procédure. Chaque publication respecte le même modèle. Et à chaque fois, cela prend 30 à 90 minutes, car il faut se rappeler les étapes, ouvrir les bons fichiers et reformuler le prompt Claude depuis le début.

La solution consiste à regrouper cette méthode dans un skill une fois pour toutes. Ensuite, vous prononcez une phrase, et Claude charge la méthode, lit les sources nécessaires et produit le résultat. Voici trois exemples dans différents domaines :

Exemple 1. Spécialiste du marketing indépendant – skill weekly-content-plan

Ce qu’il fait manuellement : chaque lundi, il prépare une semaine de publications Telegram pour trois clients. Il ouvre le guide de tonalité de marque du client, examine les publications récentes, imagine des sujets d’après le calendrier des produits et prépare un tableau avec des accroches et des puces.

Sous forme de skill, cela devient une instruction en cinq étapes : lire le fichier de tonalité du client, lire le calendrier des produits, vérifier les 10 dernières publications pour éviter les répétitions, trouver sept sujets répartis par catégorie (commercial, expertise, personnel) et produire un tableau.

La commande « planifions les publications de la semaine pour le client X » transforme une heure de préparation en trois minutes d’attente. Le spécialiste vérifie le résultat, apporte des modifications ciblées et l’envoie au client.

Exemple 2. Comptable externalisé – skill monthly-receipts-close (exemple de l’auteur)

Ce qu’il fait manuellement : chaque mois et pour chaque client de son portefeuille, il exporte le relevé bancaire, le rapproche des paiements du système comptable, signale les paiements non classés, prépare un rapport préliminaire des revenus et compare la structure des revenus à celle du mois précédent.

Le skill est une instruction en six étapes accompagnée de quelques scripts shell dans le dossier scripts/ pour analyser les relevés bancaires. Le déclencheur « clôture mai pour le client X » demande à Claude de produire un rapport signalant les anomalies en 4 à 5 minutes.

Exemple 3. Créateur de programme en ligne – skill welcome-letter-new-participant

Ce qu’il fait manuellement : un nouveau participant a payé et il faut lui rédiger un e-mail de bienvenue. Un bon message est personnalisé : il tient compte du canal par lequel la personne est arrivée, du produit acheté, de sa cohorte et des documents à joindre. Un modèle « Bonjour, nous sommes ravis » ne fait pas cela.

Le skill demande à Claude de lire knowledge/audience.md (qui sont ces personnes), knowledge/products/<product>.md (ce qu’elles reçoivent) et les trois derniers e-mails de bienvenue (pour éviter les répétitions), puis de rédiger le message selon cette structure : accroche – détails du produit – trois premières étapes – formule de clôture.

Le processus est bien plus rapide qu’un travail manuel. La qualité est plus constante, car Claude pense à consulter trois sources, alors qu’une personne pressée en oublie une.

Ce qu’il ne faut PAS transformer en skill

• Les tâches ponctuelles. Si vous ne faites une tâche qu’une fois par an, au moment de remplir votre déclaration d’impôts, décrivez-la simplement à Claude dans le chat. Un skill devient rentable après 3+ répétitions.
• Les tâches trop générales. « Aide-moi avec le marketing » n’est pas un skill, c’est l’ensemble du marketing. Un skill correspond à « un plan de contenu hebdomadaire » : une action précise avec un résultat précis.
• Les tâches sans étapes reproductibles. Si le processus change à chaque fois, ce n’est pas un skill, mais un travail ponctuel.

Comment Skill Creator crée-t-il des skills pour vous ?#

Le problème, c’est qu’il est difficile de rédiger un bon skill du premier coup. Une description est souvent trop étroite ou trop large, ne comprend pas les expressions réellement utilisées par les utilisateurs ou entre en conflit avec un skill voisin. Anthropic a répondu à cela en publiant skill-creator, un méta-skill capable de créer d’autres skills.

Après avoir installé anthropics/skills, dites à Claude /skill-creator (ou simplement « créons un skill pour le rapport hebdomadaire ») et suivez un processus en six étapes :

1. Ébauche – skill-creator pose des questions : que doit faire le skill, quelles expressions déclencheuses utiliser, quelles sources consulter et quelles étapes suivre ? Le résultat est la première version de SKILL.md.
2. Test – skill-creator génère 20 prompts de test : 10 qui doivent déclencher le skill et 10 qui ressemblent à des déclencheurs, mais ne doivent pas l’activer (des cas proches).
3. Évaluation – chaque prompt est exécuté dans un nouveau chat pour vérifier si le skill s’est activé. S’il s’active à tort ou ne s’active pas alors qu’il le devrait, le résultat est signalé.
4. Itération – la description est réécrite selon les échecs, puis les tests sont relancés.
5. Optimisation – dernière finition : vérification de la limite de 1024 caractères et des conflits éventuels avec les skills déjà présents dans le projet.
6. Empaquetage – le SKILL.md final et les fichiers de référence sont regroupés dans la bonne structure.

En pratique, cela se passe ainsi : vous discutez avec Claude pendant 15 à 20 minutes, répondez à 7 ou 8 questions de clarification et obtenez à la fin un skill prêt à l’emploi, testé et activé par les bons déclencheurs.

Autre avantage : skill-creator donne un exemple remarquable de rédaction d’un SKILL.md. Vous pouvez ouvrir son propre fichier et observer le format, le ton et la structure des étapes. L’outil montre ce qu’il enseigne : en le lisant, vous apprenez à rédiger vos propres skills.

Skills, CLAUDE.md, sous-agents, MCP, Hooks : lequel utiliser ?#

Le problème le plus courant dans les projets que j’ai examinés est que CLAUDE.md contient à la fois les règles du projet, des instructions de publication étape par étape, un modèle de commit et une description de la base de données. Cela surcharge le contexte et ne fonctionne pas non plus en pratique : Claude n’exécute pas l’instruction « quand l’utilisateur demande une publication », car le modèle traite tout le contenu de CLAUDE.md comme un contexte général sans déclencheurs explicites.

La solution consiste à attribuer chaque élément à la bonne primitive :

En bref, le tableau se résume à une logique simple : les Skills et MCP couvrent la plupart des flux de travail ; les Hooks automatisent les tâches courantes, comme les vérifications de code, les tests et les garde-fous. Les sous-agents sont nécessaires lorsque le contexte devient volumineux. L’erreur la plus courante est de créer un sous-agent alors qu’un skill devrait être utilisé.

Arbre de décision

Quand vous pensez : « J’ai besoin que Claude fasse X » :

1. Ces connaissances sont-elles nécessaires en permanence ? Par exemple : « Le projet utilise une langue définie » ou « nous n’utilisons pas de tirets cadratins ». → Mettez-les dans CLAUDE.md.
2. S’agit-il d’une procédure déclenchée que vous effectuez actuellement à la main ? Par exemple : « J’écris un rapport chaque lundi. » → Créez un skill.
3. Avez-vous besoin d’accéder à un système externe ? Par exemple à l’API Stripe ou à votre CRM. → Connectez un serveur MCP.
4. Claude Code doit-il réagir automatiquement à un événement ? Par exemple, lancer un linter après chaque Edit. → Écrivez un hook.
5. La tâche est-elle lourde, va-t-elle consommer tout le contexte, et devez-vous faire autre chose en parallèle ? → Lancez-la dans un sous-agent.

90 % des tâches d’un entrepreneur vibe-codeur relèvent des catégories 1 à 3. Les Hooks et les sous-agents sont des outils plus avancés, utiles quand on est passé à plus d’« une tâche à la fois ».

Les commandes slash et les skills, c’est la même chose

Un changement important dans Claude Code : l’ancien système de commandes slash (.claude/commands/) et les skills ont, dans les faits, fusionné. Le fichier .claude/commands/deploy.md et .claude/skills/deploy/SKILL.md créent tous deux une commande /deploy. Si leurs noms correspondent, le skill l’emporte. Si vous utilisez encore l’ancien format de commandes slash, passez aux skills : la syntaxe est plus claire et offre davantage de possibilités.

7 erreurs qui empêchent un skill de fonctionner#

1. Une description sans déclencheurs : le skill ne s’active pas

Symptôme : vous avez écrit un skill, vérifié sa structure, tout est valide, mais Claude ne l’invoque pas pour les demandes des utilisateurs. La cause est presque toujours la même : une description comme « Assistant pour la rédaction de contenu ». Claude ne sait pas à quelles expressions réagir. Solution : mettez 3 à 5 expressions réellement utilisées par les utilisateurs entre guillemets dans la description.

2. SKILL.md dépasse 500 lignes : l’attention se disperse

Anthropic recommande explicitement de limiter le corps du fichier à 500 lignes. Si vos instructions font 2,000 lignes, Claude perd le fil, ne suit que partiellement les étapes et s’embrouille dans leur ordre. Solution : déplacez les grandes sections dans des fichiers à proximité, sous examples/, references/ ou scripts/, et renvoyez-y depuis SKILL.md.

3. Un seul skill pour « tout ce qui touche au contenu » au lieu de trois petits skills

Une configuration tentante : un grand skill content qui regroupe les publications Telegram, les pages d’atterrissage et les e-mails. Ça ne fonctionne pas. Le skill s’active pour les mauvaises demandes, mélange les méthodes et produit un résultat moyen. Solution : un skill correspond à une action reproductible. Si vous avez vraiment trois routines liées au « contenu », créez trois skills : telegram-post, landing-section, email-broadcast.

4. Un skill sans section « Quand NE PAS l’utiliser » : conflits

Symptôme : il y a deux skills similaires dans le projet, et Claude invoque le mauvais. Par exemple, un skill concerne les newsletters par e-mail et un autre les e-mails de bienvenue destinés aux participants d’un programme. Sans clause explicite « ne pas activer si la demande concerne une liste de diffusion générale », le skill consacré aux e-mails de bienvenue se déclenchera à chaque mention d’« e-mail ». Solution : indiquez explicitement les cas négatifs dans la description.

5. 50 skills dans un projet : les descriptions sont tronquées

Extrait de la documentation Claude Code :

Si vous avez téléchargé 50 collections de skills depuis un marketplace, certaines descriptions seront tronquées. Les mots-clés sur lesquels vous comptiez risquent de disparaître. Solution : gardez les 10 à 15 skills les plus utiles dans le projet actif. Conservez les autres dans une archive inactive hors de tous les dossiers de skills découvrables, par exemple un dossier skill-archive/ séparé dans vos ressources. Installez seulement les skills utiles dans le projet ou l’espace personnel. ~/.claude/skills/ est une bibliothèque personnelle installée, visible dans tous les projets : y déplacer une skill ne la retire pas de la découverte.

6. Des skills provenant de sources non vérifiées : un risque pour la sécurité

Anthropic met en garde contre ce risque dans la documentation officielle :

Un dépôt GitHub quelconque peut contenir un skill qui divulgue vos clés API dès sa première invocation. Solution : ouvrez SKILL.md et lisez-le vous-même avant de l’installer. N’exécutez pas de skills d’auteurs inconnus dans des projets importants.

7. Un skill sans dossier de connaissances produit du « ChatGPT moyen »

C’est l’anti-pattern le plus subtil et le plus courant. Un skill est une méthode, mais sans contexte la méthode ne signifie rien. Si vous créez un skill « rédiger un e-mail de bienvenue », mais que le projet ne contient ni fichier décrivant le public ni fichier sur la voix de la marque, Claude rédigera un e-mail ChatGPT moyen, impossible à distinguer de ceux de tous les autres.

Un skill donne les meilleurs résultats si vous avez déjà construit le Second Brain du projet selon les principes du guide consacré à CLAUDE.md. Commencez par bâtir la structure des connaissances, puis créez les skills qui en dépendent. Inversez l’ordre et vous obtiendrez un travail routinier et de qualité moyenne au lieu d’un travail personnalisé dans votre style.

Comment créer son premier skill en 30 minutes#

Voici le plan concret que j’ai utilisé pour créer les premiers skills de mes projets :

Étape 1. Choisir une action reproductible

Ouvrez votre calendrier du mois passé. Repérez une tâche effectuée au moins 4 ou 5 fois, qui prend 30 à 60 minutes à chaque fois. Pas un vaste sujet comme le « marketing », mais une tâche précise : « rapport des ventes du lundi », « intégration d’un nouveau client » ou « mise à jour de la liste de prix pour une promotion ».

Plus la formulation est précise, plus le skill est simple et le déclencheur clair.

Étape 2. Écrire la procédure à la main

Dans un fichier séparé ou dans un chat avec Claude (pas encore pour le skill, mais sous forme de brouillon), écrivez les étapes que vous suivez :

1. Open the client database
2. Filter by status "awaiting welcome email"
3. Check which channel the client came from
4. Get the email template for that channel from the "templates" folder
5. Fill in the name, product, and start date
6. Send

Ce n’est pas encore un skill, ce sont des notes. Mais sans ces notes, vous serez perdu dès le début de la rédaction de SKILL.md.

Étape 3. Créer la structure des dossiers

mkdir -p .claude/skills/welcome-email-new-client
touch .claude/skills/welcome-email-new-client/SKILL.md

Ou, si vous souhaitez utiliser le skill dans tous vos projets, placez-le dans ~/.claude/skills/.

Étape 4. Rédiger SKILL.md à l’aide du modèle

Structure :

---
name: welcome-email-new-client
description: |
  Prepares a welcome email for a new client using the template for their acquisition channel.
  Triggers: "write a welcome email for new client X",
  "onboard new participant Y", "welcome email for client from channel Z".
  Do not activate if the request is about a general mailing list
  or an email campaign—those are other skills.
---

# Welcome Email for a New Client

## Steps

1. Read `knowledge/audience/segments.md` - what client segments we have
2. Read `knowledge/templates/welcome/` - templates by channel
3. Identify the client's channel from the request context
4. Insert the client's name, product name, and start date
5. Check the length—it should be no more than 800 characters
6. Output the final email text in a copy-ready format

## Important

- Do not use “dear friend” or “hello”—use natural speech
- One paragraph, one idea
- End with one call to action, not two

Étape 5. Tester avec 5 à 8 prompts

Ouvrez un chat vierge avec Claude Code dans ce projet. Essayez 5 expressions que vous utilisez réellement, plus 3 expressions similaires qui ne devraient pas activer le skill :

Doivent déclencher le skill :

• “Write a welcome email for new client Ivanov”
• “Onboard a new participant who bought program X”
• “Welcome email for a client from Instagram”

Ne doivent pas le déclencher :

• “Send a promotion email to the whole list”
• “Email campaign for the New Year holidays”
• “Write a follow-up to a client who hasn't paid”

Pour chacune, vérifiez si le skill s’est activé. S’il s’active dans les mauvais cas, resserrez la description. S’il ne s’active pas lorsqu’il le devrait, élargissez les expressions déclencheuses.

Étape 6. Retravailler la description

Après chaque test raté, ne modifiez que la description — ne touchez pas au corps des instructions. Après 2 ou 3 itérations, le skill s’active de manière fiable. Enregistrez-le, faites-en un commit, puis utilisez-le tous les jours.

Dernier conseil : ne cherchez pas à rendre votre premier skill parfait. Faites-le fonctionner. Vous le peaufinerez après votre cinquième ou dixième skill, quand vous commencerez à repérer des schémas dans vos formulations et dans les réponses de Claude.

Choisissez cette semaine une tâche récurrente de votre calendrier, réservez-y 30 minutes et suivez les six étapes ci-dessus. Claude appliquera alors votre méthode au lieu de deviner.

La configuration opérationnelle repose sur clone IA + Second Brain + Context Engineering. Trois éléments d’une même méthode.

Si vous avez besoin d’accéder à des modèles d’IA via Ailoot, découvrez Ailoot.