Écrire son skill

Séance 2 · vendredi 13 novembre · le reste de la matinée

Les slides du chapitre (PDF)PDF

• Répondre par écrit aux neuf questions qui définissent un skill de veille.
• Écrire sa version du skill, en faire écrire une autre par un agent, puis comparer les deux.
• Tester son skill dans trois agents et transformer chaque erreur en règle.
• Choisir entre des sources libres et une liste fermée, puis son format et son classement.
• Garder chaque version dans un commit, avec ce qui a changé et pourquoi.

La veille commune suit les nouveautés de l'IA pour toute la classe. Votre veille à vous suit votre question, celle de votre fiche de départ. Elle a besoin de son propre skill, avec vos rubriques, vos règles et votre façon de choisir les sources. Vous l'écrivez vous-mêmes, puis vous l'améliorez en le lançant, version après version, jusqu'à ce que sa veille vous convienne.

1. Neuf questions avant d'écrire#

Un skill flou donne une veille floue. Avant d'écrire une ligne, répondez par écrit à ces neuf questions, en une ou deux phrases chacune.

Question	Ce qu'elle décide	Exemple pour la question « Énergie et eau »
1. Quel sujet ?	La phrase que l'agent garde en tête	Combien d'électricité et d'eau consomme l'IA.
2. Quels mots pour le lancer ?	La description du skill	« lance ma veille », « quoi de neuf sur l'énergie de l'IA »
3. Quelles sources ?	Des sources libres, ou une liste fermée	Libres, mais l'AIE et les rapports des hébergeurs sont relus chaque semaine.
4. Qu'est-ce qui est neuf ?	Le tri	Un chiffre nouveau, une étude, une annonce de centre de données.
5. Quelles rubriques ?	Le classement	Chercheurs, entreprises d'IA, médias.
6. Quel format ?	Le fichier rendu	Une ligne par fait, le chiffre en gras, quinze lignes au plus.
7. Et quand rien ne marche ?	Les cas limites	Rien de neuf, une source muette, une date absente.
8. Qu'est-ce qui est interdit ?	Les règles	Inventer un chiffre, citer un site sosie.
9. Comment relirez-vous chaque veille ?	Votre relecture, à vous	J'ouvre deux lignes au hasard dans chaque veille et je leur pose les quatre questions : le lien, le contenu, la date, le domaine.

Les questions 4 et 7 sont celles qu'on oublie. Sans elles, l'agent décide seul ce qui est neuf, et il remplit les semaines creuses avec ce qu'il trouve.

La question 9 ne s'adresse pas à l'agent. Les huit premières réponses vont dans le skill. La neuvième décrit ce que vous faites, vous, chaque fois qu'une veille arrive : combien de lignes vous ouvrez, et ce que vous vérifiez sur chacune. Écrivez cette procédure en deux phrases. Elle doit tenir en cinq minutes, sinon vous ne la ferez pas chaque semaine.

2. Votre version, à la main#

Votre skill vit dans le même dossier veille-ia que le skill commun. Vous y créez deux sous-dossiers : ma-veille dans .agents\skills\, pour le skill, et ma-veille à la racine, pour ce qu'il écrit :

Un mot, trois sens. Dans ce chapitre, « dossier » tout seul désigne un dossier de votre ordinateur. Le « dossier du skill » est celui qui contient SKILL.md. Le travail que vous rendez à la fin du cours s'appelle toujours « le dossier de veille ».

veille-ia\
├── .agents\
│   └── skills\
│       ├── nouveautes-ia\     déjà là : le skill commun
│       │   └── SKILL.md
│       └── ma-veille\         à créer : le dossier de votre skill
│           └── SKILL.md       à créer : votre skill
├── AGENTS.md                  déjà là
├── sources.md                 déjà là : les sources de la veille commune
├── veille\                    déjà là : les veilles communes
└── ma-veille\                 à créer : les veilles de votre question
    └── sources.md             à créer, par vous ou par l'agent : vos sources

Écrivez SKILL.md avec vos réponses. Le skill commun peut vous servir de modèle pour la forme, pas pour le contenu. Un squelette suffit :

---
name: ma-veille
description: (ce que fait le skill, et les mots qui le lancent)
---

# (votre question)

## Étapes
1. Trouver la date de la dernière veille dans ma-veille/.
2. (vos sources : chercher librement, ou lire ma-veille/sources.md)
3. Garder ce qui est neuf, selon (votre réponse à la question 4).
4. Écrire ma-veille/AAAA-MM-JJ-outil-modele.md avec le format ci-dessous.
5. Finir le fichier par la liste des sources utilisées.

## Règles
- (une règle par ligne)

## Format
(le modèle exact du fichier rendu)

Le nom du dossier du skill et la ligne name: sont identiques, en minuscules, avec des tirets. Pour Claude Code, demandez-lui de copier ce dossier dans .claude\skills\.

3. Une autre version, par un agent#

Vous avez votre version. Vous allez maintenant en faire écrire une autre par un agent, pour la même question, sans lui montrer la vôtre. Le but est de comparer les deux à l'étape suivante : ce que l'un a prévu et que l'autre a oublié.

La plupart des agents ont déjà un skill qui sert à écrire des skills. Dans Codex, il s'appelle skill-creator. Il suffit de demander à l'agent de l'utiliser : il vous pose des questions, puis il écrit le skill. Vous pouvez aussi lui demander d'enregistrer le nouveau skill, et il crée lui-même le dossier et le fichier au bon endroit.

Ouvrez un autre dossier, vide, dans un agent : il ne doit pas pouvoir lire votre version. Demandez-lui un skill pour la même question :

Utilise ton skill qui écrit des skills. Écris un skill de veille hebdomadaire
pour ma question : (votre question, telle qu'elle est écrite dans votre
dossier). Il ne garde que ce qui est paru depuis la dernière veille.
Enregistre-le dans .agents/skills/ma-veille/.

4. Comparer, puis écrire la version 2#

Vous avez maintenant deux versions du même skill : la vôtre et celle de l'agent. Posez-les côte à côte et cherchez trois choses :

• ce que l'agent a prévu et pas vous, par exemple une règle sur les doublons ;
• ce que vous avez prévu et pas lui, souvent ce qui tient à votre question ;
• ce qui reste flou chez l'un ou l'autre, par exemple « les articles importants » sans dire ce qui rend un article important.

Écrivez maintenant la version 2 de votre skill : elle garde le meilleur des deux. Votre version à la main était la version 1. Celle de l'agent n'a servi qu'à comparer : vous ne la gardez pas. Vous pouvez l'écrire vous-mêmes ou la faire écrire par l'agent, en lui donnant les deux versions et vos remarques. Dans les deux cas, relisez-la ligne par ligne : c'est votre skill, et c'est vous qui en répondez dans le rapport de veille.

5. Tester et corriger#

Lancez la version 2 dans vos trois agents :

Lance ma veille.

Vérifiez deux lignes de chaque veille avec les quatre questions de la veille commune : le lien, le contenu, la date sur la page, le domaine. Notez chaque erreur.

Chaque erreur devient une règle, ou rend une règle plus claire. Une nouveauté sans date ? Ajoutez « sans date lue sur la page, le fait n'entre pas dans la veille ». Un chiffre recopié d'un média alors que l'étude existe ? Ajoutez « pour un chiffre, remonter à l'étude qui l'a mesuré ». Puis relancez, et recommencez.

Surveillez aussi l'effet inverse. Une règle trop stricte peut faire rater de vraies nouveautés. Si une veille dit « Rien de neuf » alors que vous connaissez une nouveauté de la semaine, une de vos règles est trop dure.

Arrêtez-vous quand deux lancements de suite vous rendent une veille que vous recopieriez dans votre journal sans rien corriger.

6. Personnaliser#

Le skill commun fait des choix pour toute la classe. Le vôtre peut en faire d'autres, par exemple écrire un résumé de chaque nouveauté.

Ce que vous réglez	Quelques choix possibles
Le format	une ligne par fait · un tableau · une fiche de résumé par nouveauté · un résumé de trois lignes en tête · une note d'importance de 1 à 3
Le classement	par voix : chercheurs, entreprises d'IA, médias · par type de fait · par importance
Les sources	libres · une liste fermée de sites vérifiés · les primaires d'abord · une rubrique « à surveiller » pour une source qui publie rarement
La longueur	dix lignes · quinze lignes · sans limite, mais triées

Choisissez ce qui vous servira pour le dossier de veille. S'il est construit sur les trois voix, une veille classée par voix vous fait gagner du temps chaque semaine.

7. Vos sources : libres ou choisies#

Vous décidez d'où viennent les nouveautés de votre veille. Deux réglages sont possibles, et vous pouvez passer de l'un à l'autre d'une version du skill à la suivante.

	Sources libres	Liste fermée
Ce que dit le skill	« Cherche sur le web, et liste tes sources à la fin de la veille. »	« Ne lis que les sources de ma-veille/sources.md. »
Ce que vous y gagnez	des sources auxquelles vous n'auriez pas pensé	des sites que vous avez déjà vérifiés
Ce que vous surveillez	chaque nouvelle source : qui écrit, et pourquoi	ce que votre liste ne voit pas

Dans les deux cas, ma-veille\sources.md garde la trace de vos sources. Avec une liste fermée, vous l'écrivez vous-mêmes. Avec des sources libres, vous y rassemblez après chaque veille les sources que les agents ont citées, comme pour la veille commune. Ce fichier compte quinze sources au minimum, et autant que vous voulez au-delà. Au moins cinq sont de première main : elles ont fait la mesure ou l'étude elles-mêmes. Marquez chacune « primaire » ou « secondaire ».

Voici le début d'un sources.md pour la question « Énergie et eau », classé par voix :

## Chercheurs
- AIE, rapport « Energy and AI » (primaire) : https://www.iea.org/reports/energy-and-ai
- arXiv, « Making AI Less Thirsty », l'étude sur l'eau (primaire) : https://arxiv.org/abs/2304.03271
- Hugging Face, AI Energy Score, des mesures par modèle (primaire) : https://huggingface.co/AIEnergyScore
- Arcep, l'empreinte environnementale du numérique (primaire) : https://www.arcep.fr/la-regulation/grands-dossiers-thematiques-transverses/lempreinte-environnementale-du-numerique.html

## Entreprises d'IA
- Google, rapports environnementaux (primaire) : https://sustainability.google/reports/
- Google Cloud, la mesure d'une requête Gemini (primaire) : https://cloud.google.com/blog/products/infrastructure/measuring-the-environmental-impact-of-ai-inference
- Mistral, l'analyse de cycle de vie de son modèle (primaire) : https://mistral.ai/news/our-contribution-to-a-global-environmental-standard-for-ai
- Amazon, rapport de durabilité (primaire) : https://sustainability.aboutamazon.com/

## Médias
- MIT Technology Review, rubrique climat (secondaire) : https://www.technologyreview.com/topic/climate-change/
- Le Monde, Pixels (secondaire) : https://www.lemonde.fr/pixels/
- Next (secondaire) : https://www.next.ink/
- The Guardian, rubrique IA (secondaire) : https://www.theguardian.com/technology/artificialintelligenceai

Une entreprise qui mesure sa propre consommation est une source primaire : elle a fait la mesure. Elle n'est pas neutre pour autant, puisqu'elle parle d'elle-même. Vous y reviendrez à la séance 3, sur la critique des sources.

Un flux RSS se lit mieux qu'une page d'accueil : il donne la date de chaque article. Certains agents ne savent pourtant pas le lire. Si votre liste contient un flux, donnez à côté la page web où on retrouve les mêmes articles. Une liste X ou un fil Bluesky demandent une connexion, et un agent ne les lit pas. Ces sources-là, vous les lisez vous-mêmes, et vous les gardez dans la bibliographie.

8. Un site de synthèse pour votre veille#

Comme pour la veille commune, vos résultats se lisent mieux dans un site que dans trois fichiers. Quand vos agents ont rendu leurs veilles, reprenez la consigne du site de synthèse du chapitre « Trois agents, une veille commune » et donnez-la à un seul d'entre eux, le plus solide. Changez-y trois choses :

• les dossiers : ma-veille/, ma-veille/fiches/ si votre skill écrit des fiches, et ma-veille/sources.md ;
• le classement : vos rubriques, ou vos trois voix (chercheurs, entreprises d'IA, médias) ;
• le lecteur : dites pour qui le site est écrit, vous, votre duo ou le jury du dossier de veille.

Redemandez le site après chaque nouvelle veille, il grandit avec vos veilles. Il se vérifie comme les fichiers dont il vient : deux lignes au hasard, les quatre questions.

9. Chaque version dans un commit#

Trois mots de git servent ici.

• Un dépôt : un dossier dont git garde l'historique. Il peut avoir une copie en ligne, sur GitHub.
• Un commit : une version enregistrée par git, avec un message qui dit ce qui a changé.
• Pousser (git push) : envoyer vos commits vers la copie en ligne.

Vous ne créez pas le dépôt vous-mêmes. Demandez-le à l'agent :

Initialise git dans ce dossier, crée un dépôt privé sur mon compte GitHub,
fais un premier commit et pousse-le.

Dans l'app ChatGPT et dans l'app Claude, l'agent passe par votre compte GitHub. En général, vous le liez une fois dans les paramètres de l'app. Sans ce lien, l'agent utilise simplement git en ligne de commande. S'il n'arrive pas à créer le dépôt, il vous dit ce qui lui manque.

Ensuite, faites un commit par version du skill, avec un message qui dit ce qui a changé et pourquoi : « v3 : sans date lue, le fait n'entre pas dans la veille (deux annonces de 2025 dans la v2) ». L'historique des commits montre comment votre veille s'est améliorée. C'est la matière de la partie 2 du dossier de veille et de la partie 7, ce que vous changeriez à votre veille.

Écrivez ensuite l'entrée 1 du journal, dans la partie 2 du dossier de veille : la date, vos trois agents et leurs modèles, les versions du skill et ce que chacune a corrigé, ce que vous avez vérifié.

10. Lancer chaque semaine#

Une veille se lance au moins une fois par semaine. Le plus simple est de le demander à votre agent : vous ouvrez le dossier veille-ia dans l'agent et vous tapez « Lance ma veille. », une ou plusieurs fois dans la semaine.

Pour un lancement automatique, vous avez deux chemins :

• le régler à la main dans l'interface de l'agent, quand elle propose des tâches planifiées ;
• le demander à l'agent : « Configure le lancement automatique de ma veille, chaque vendredi à 8 h. » S'il ne peut pas le faire lui-même, demandez-lui comment faire.

Une tâche planifiée sur votre ordinateur tourne seulement s'il est allumé : un portable fermé le vendredi matin ne fait pas sa veille. Elle écrit aussi chaque semaine un fichier qui a l'air sérieux. Relisez-le comme les autres.

Pour le 20 novembre

• Lancez la veille commune avant le cours et apportez le fichier : la séance commence par les nouveautés de la semaine.
• Lancez votre skill au moins une fois dans la semaine, et finissez l'entrée 1 du journal.
• Apportez votre sources.md : la séance 3 commence par la critique des sources.

À retenir#

• Un skill de veille se décide avec neuf questions, dont deux qu'on oublie : ce qui est neuf, et que faire quand rien ne marche. La neuvième décrit votre relecture, pas le travail de l'agent.
• Votre version et celle d'un agent, écrites sans se regarder, se comparent, et la version 2 garde le meilleur des deux.
• Chaque erreur vue en lançant le skill devient une règle, et une règle trop dure fait rater de vraies nouveautés.
• Vos sources sont libres ou choisies, et sources.md en garde quinze au minimum, dont cinq de première main.
• Chaque version du skill entre dans un commit qui dit ce qui a changé et pourquoi.