FreeAILab free-ai-lab

Guide d'écriture de SKILL.md

Tutoriel avancé

Guide de champs + 10 modèles prêts à copier + conseils avancés pour rendre les Skills plus stables.

En une phrase : Un SKILL.md n'est que trois parties : l'en-tête « dit à l'IA qui vous êtes et quand l'utiliser », le corps est « exactement comment faire », et les exemples montrent « à quoi ressemble le résultat ». Cet article détaille chaque champ puis vous donne 10 modèles que vous pouvez copier directement.

Pour les débutants complets, commencez par le tutoriel de création en quatre étapes ; cet article est la référence avancée.

Vue d'ensemble de la structure

--- name: skill-name ← id en minuscules avec kebab-case description: ce qu'elle fait + quand l'utiliser ← le plus critique ; l'IA juge l'activation selon cela --- # Titre principal (corps : étapes, règles, limites) ## Exemples (entrée → sortie, pour montrer à l'IA le niveau à viser)
frontmatter (en-tête)

name + description, au format YAML

Corps

étapes concrètes + limites + règles ; plus c'est spécifique, plus c'est stable

Exemples

entrée → sortie idéale, fixant le standard que l'IA doit produire

Écrire les meilleurs champs d'en-tête

description est la clé

Elle décide « quand l'IA se souvient de cette Skill ». Plus elle ressemble aux mots mêmes de l'utilisateur, plus le taux de réussite est élevé.

❌ Trop vague (l'IA ne saura pas quand l'utiliser)
description: Aide à écrire des textes publicitaires
✅ Précis (couverture complète des scénarios d'activation)
description: Écrit des publications de notes produit dans un style de contenu viral court. À utiliser quand l'utilisateur dit « écris une publication pour les réseaux sociaux », « aide-moi à rédiger une pièce promotionnelle du produit » ou colle des informations produit.
Convention de nommage dans name

Lettres minuscules + tirets (p. ex., weekly-report-writer), pour que sa fonction soit évidente d'un coup d'œil. N'utilisez ni espaces, ni majuscules, ni caractères non latins.

10 modèles de scénarios prêts à copier

Enregistrez n'importe lequel des suivants comme dossier (contenant un SKILL.md du même nom) et il fonctionnera — changez seulement les exemples :

1️⃣ Skill de notes de réunion
--- name: meeting-notes description: Convertit des transcriptions de réunions en comptes rendus structurés. À utiliser quand l'utilisateur colle des notes de réunion ou dit « organise la réunion d'aujourd'hui ». --- # Compte rendu de réunion 1. D'abord identifiez et affichez : sujet, heure, participants 2. Organisez en trois sections : « décisions / tâches en attente / questions ouvertes » 3. Une tâche par personne, format : responsable + quoi faire + échéance (les infos manquantes marquées [TBD]) 4. N'ajoutez pas d'informations absentes des notes ## Exemple Entrée : Lors de la réunion d'aujourd'hui, on a décidé d'ajouter une fonctionnalité d'export au produit ; je suis responsable du backend, Xiao Zhang du frontend, démo vendredi... Sortie : ### Décisions - Ajouter une fonctionnalité d'export au produit ### Tâches en attente - Ming : implémentation de l'export côté backend (échéance [TBD])
2️⃣ Skill de polissage d'e-mail (ton professionnel)
--- name: email-polisher description: Réécrit des brouillons d'e-mails bruts en e-mails professionnels. À utiliser quand l'utilisateur colle un brouillon d'e-mail ou dit « peaufine mon e-mail ». --- # Polissage d'e-mail 1. Conservez tous les points d'information clés 2. Améliorez la courtoisie de la salutation, de l'ouverture et de la conclusion 3. Coupez les phrases longues ; une idée par paragraphe 4. Sortie : e-mail poli + résumé des modifications en 3 lignes ou moins ## Exemple Entrée : Bonjour patron, la collaboration dont on a parlé est confirmée, quand voulez-vous signer ? Sortie : Cher M. Wang, concernant la collaboration évoquée précédemment, nous avons confirmé que nous allons de l'avant. Merci de nous indiquer quand cela vous conviendrait et nous pourrons organiser la signature à votre convenance. Cordialement !
3️⃣ Skill de rapport hebdomadaire
--- name: weekly-report description: Convertit des journaux de travail épars en un rapport hebdomadaire clair et structuré. À utiliser quand l'utilisateur colle un mélange de notes ou dit « écris mon rapport hebdomadaire ». --- # Génération de rapport hebdomadaire 1. Classez les notes en « résultats de cette semaine / problèmes rencontrés / plans de la semaine prochaine » 2. Classez les résultats par importance, chacun avec des données à l'appui (ajoutez [TBD] si manquant) 3. Proposez 2 titres suggérés au choix 4. Tenez-vous aux faits ; n'inventez pas d'événements qui n'ont pas eu lieu ## Exemple…
4️⃣ Skill de polissage de CV
--- name: resume-polisher description: Peaufine les descriptions du CV pour qu'elles soient plus professionnelles et quantifiables. À utiliser quand l'utilisateur colle un CV ou dit « optimise mon CV ». --- # Polissage de CV 1. Commencez par des verbes d'action (p. ex., « j'ai dirigé », « j'ai mis en œuvre »), évitez la première personne 2. Quantifiez les résultats quand c'est possible (chiffres, pourcentages) ; conservez l'original sinon 3. Gardez chaque entrée d'expérience en 1–2 lignes ; coupez le superflu et le remplissage 4. Sortie : liste polie + une note sur ce qui a changé et pourquoi
5️⃣ Skill de revue de code front-end
--- name: frontend-code-review description: Revient le code front-end pour la maintenabilité et l'accessibilité. À utiliser quand l'utilisateur dit « revois ce code » ou colle du code. --- # Revue de code front-end 1. Vérifiez chaque élément : lisibilité / accessibilité (aria) / performances (rendus répétés) / sécurité (XSS) 2. Pour chaque problème, donnez : fichier + ligne, le problème et le code de la solution suggérée 3. Classez la sortie par gravité 4. S'il n'y a aucun problème, dites clairement « aucun problème trouvé »
6️⃣ Skill de génération de prompts d'image
--- name: image-prompt-writer description: Convertit une description de scène en un prompt de génération d'images IA anglais de haute qualité. À utiliser quand l'utilisateur dit « écris-moi un prompt d'image ». --- # Prompt de génération d'image 1. Sortie en anglais, structurée : sujet + environnement + éclairage + composition + style + étiquettes de qualité 2. Terminez par des étiquettes de qualité fixes : high quality, 4k 3. Choisissez automatiquement un descripteur de style adapté à la scène (réaliste / illustration / 3D / affiche) 4. Après le prompt, ajoutez une explication de 2 lignes
7️⃣ Skill d'organiseur de notes de cours
--- name: study-notes description: Organise du matériel d'étude épars en notes structurées et cartes mémoire. À utiliser quand l'utilisateur colle du matériel ou dit « organise mes notes de cours ». --- # Notes de cours 1. Extrayez les concepts clés, chacun commençant par une « définition en une phrase » 2. Organisez hiérarchiquement par sujet, en ajoutant des exemples 3. Générez 5 cartes mémoire de questions/réponses 4. Sortie en Markdown prête à être importée dans une app de notes
8️⃣ Skill d'interprétation d'analyse de données
--- name: data-interpreter description: Interprète un ensemble de données (tableau/chiffres) et donne des conclusions et recommandations. À utiliser quand l'utilisateur colle des données ou dit « analyse ces données ». --- # Interprétation de données 1. Résumez d'abord la vue d'ensemble puis listez les tendances/valeurs aberrantes notables 2. Distinguez « faits issus des données » de « déductions » ; étiquetez toute déduction 3. Donnez 3 suggestions d'étapes suivantes actionnables ou plus 4. Affichez les comparaisons sous forme de tableau
9️⃣ Skill de scénario de vidéos courtes
--- name: short-video-script description: Convertit un sujet en un scénario de vidéo courte parlée de 30–60 secondes. À utiliser quand l'utilisateur dit « écris un scénario de vidéo courte » ou « convertis ce texte en scénario vidéo ». --- # Scénario de vidéo courte 1. Structure : accroche de 3 secondes + cœur de 15 secondes + appel à l'action final 2. Rendez-le parlé : phrases courtes, ton décontracté, marques de pause 3. Donnez une indication visuelle toutes les 10 secondes (plan / sous-titre) 4. Restez sous les 45 secondes, environ 300 mots
🔟 Skill de planification de voyage
--- name: travel-planner description: Produit un itinéraire de voyage selon durée/budget/préférences. À utiliser quand l'utilisateur dit « aide-moi à planifier un voyage » ou « fais-moi un guide de voyage ». --- # Planification de voyage 1. Confirmez d'abord les entrées : nombre de jours, budget, origine et destination, préférences (gastronomie / nature / culture) 2. Programmez chaque jour matin/midi/soir : attractions + transport + repas 3. Marquez le temps de visite prévu à chaque attraction 4. Incluez : un tableau de budget estimé + 3 conseils pratiques (comme réservations/météo)

L'esprit des modèles : transformer des « flux de travail répétés à haute fréquence » en une Skill est un usage plus avancé que de sauvegarder des prompts dans ses favoris — installez-la une fois et l'IA suivra votre standard à chaque fois ensuite.

Conseils avancés : rendre les Skills plus stables

  • Ajoutez des « contre-exemples » : écrire « ne fais pas X » dans le corps réduit nettement les excès (p. ex., « n'invente pas de données », « ne change pas les noms quand tu n'es pas sûr »)
  • Spécifiez le format de sortie : exigez explicitement « forme de tableau », « en-têtes ### », « 3 lignes ou moins » — la structure de sortie de l'IA devient plus stable
  • Ancrez avec des exemples à la fin : les exemples ne sont pas que décoratifs ; ce sont la référence qui aligne l'IA sur le standard de production
  • Utilisez scripts/ pour le travail mécanique : laissez le calcul et la mise en forme répétitifs aux scripts ; SKILL.md ne fait que « diriger »
  • Peaufinez de façon itérative : testez 3 entrées → ajoutez au corps les endroits où l'IA s'est trompée → retestez ; les Skills deviennent plus précises plus vous les utilisez

Lectures liées