La note de qualité des ressources IA

Chaque skill, agent et règle reçoit une note sur 100, calculée d'après des bonnes pratiques publiques. Tu vois quelles vérifications passent, lesquelles échouent, et ce qu'il faut changer dans le dépôt.

Avant de commencer

Compass est allumé et les ressources IA aussi. Astrolabe crée trois compas pour toi : Skills IA, Agents IA et Règles IA. Un runbook n'a pas de note.

🧭 Lire la note

1. Dans la barre latérale, clique sur Ressources IA. Une carte montre Note : 100/100, ou Note : 40/100.

2. Clique sur le nom d'une ressource, puis sur l'onglet Compass. Une jauge montre la note, et sous Évaluations chaque vérification a une coche verte (elle passe) ou une croix rouge (elle échoue).

3. Clique sur une vérification pour l'ouvrir. Elle montre son Résultat (Réussi ou Échoué), ce qu'Astrolabe a Lu dans le fichier (un champ entre guillemets, (vide) quand il manque, ou un nombre de lignes, de caractères ou d'octets), ce qui est Attendu quand la vérification a une limite (par exemple au plus 200 lignes), ce qu'il faut changer quand elle échoue, Corriger dans la source pour ouvrir le fichier, la Source à lire et son poids. Pour l'agent helper, Modèle déclaré dit :

   • Résultat : Échoué
   • Lu dans model : (vide)
   • Corriger dans la source
   • À faire : Indiquez model (sonnet, opus, haiku ou inherit), pour que son coût et son comportement soient connus.
   • Choix d'Astrolabe, inspiré de la source — La page citée le recommande ; Astrolabe en fait une vérification.
   • poids : 25 %

4. Clique sur Source pour ouvrir la page d'où vient la vérification.

Les vérifications qui concernent le fichier se partagent la note à parts égales : un agent Claude Code a quatre vérifications de 25 % chacune.

🏷️ Écrit par la source, ou choix d'Astrolabe

Sous chaque vérification, une de ces étiquettes dit d'où elle vient, suivie de ce qu'elle veut dire :

Étiquette	Sens
Écrit par la source	La page derrière Source énonce la règle.
Choix d'Astrolabe, inspiré de la source	La page ne l'exige pas ; Astrolabe la demande parce qu'elle aide à trouver une ressource et à lui faire confiance.
Règle de l'entreprise	Ton entreprise l'a écrite dans Astrolabe. Page de l'entreprise ouvre la page que ton entreprise a donnée pour elle.

✅ Les vérifications d'un skill

Vérification	Quoi faire quand elle échoue	Étiquette
Le nom suit le standard	Indiquez name dans SKILL.md : de 1 à 64 lettres minuscules, chiffres et tirets (pdf-processing).	Écrit par la source
Le nom est celui du dossier	Donnez à name, dans SKILL.md, le nom de son dossier.	Écrit par la source
A une description	Écrivez une description dans SKILL.md, de 1 024 caractères au plus.	Écrit par la source
Aucune balise XML	Retirez les balises du nom et de la description.	Écrit par la source
Moins de 500 lignes	Sortez les détails de SKILL.md vers les fichiers qu'il cite : gardez-le sous les 500 lignes.	Écrit par la source
Dit quand l'utiliser	Dites dans la description quand utiliser le skill (« Use when… »).	Écrit par la source
Nom précis	Renommez le skill : helper, utils, tools, documents, data ou files ne disent rien de ce qu'il fait.	Écrit par la source
Chemins avec des barres obliques	Écrivez les chemins du skill avec /, jamais \.	Écrit par la source
Licence déclarée	Indiquez license dans SKILL.md, pour qu'on sache si on peut le réutiliser.	Choix d'Astrolabe
Étiqueté	Ajoutez des tags à l'en-tête, ou au dépôt dans le catalogue, pour qu'on le trouve dans le magasin.	Choix d'Astrolabe

En clair : le nom suit le standard (1 à 64 minuscules, chiffres et tirets), le nom est celui du dossier, la description existe (1 024 caractères au plus), pas de balises XML, SKILL.md sous 500 lignes, la description dit quand s'en servir, le nom n'est pas générique, pas d'antislash dans les chemins, une licence, au moins un tag.

Sources : la spécification Agent Skills, les bonnes pratiques d'Anthropic, les skills de Claude Code et le guide entreprise d'Anthropic.

✅ Les vérifications d'un agent

Vérification	Quoi faire quand elle échoue	Étiquette
A un nom et une description	Indiquez name et description dans l'en-tête de l'agent.	Écrit par la source
Dit quand l'utiliser	Dites dans la description quand utiliser l'agent (« Use proactively after… »).	Écrit par la source
Outils limités	Listez dans tools les outils dont l'agent a besoin : sans cette liste, il les reçoit tous.	Écrit par la source
Modèle déclaré	Indiquez model (sonnet, opus, haiku ou inherit), pour que son coût et son comportement soient connus.	Choix d'Astrolabe
Dans la limite de Copilot	Raccourcissez le prompt de l'agent : Copilot en lit 30 000 caractères au plus.	Écrit par la source

En clair : un nom et une description, la description dit quand déléguer, la liste tools est limitée (sans elle l'agent les reçoit tous), un model est déclaré, et le prompt tient dans les 30 000 caractères que Copilot lit.

Sources : les sous-agents de Claude Code et les agents personnalisés de GitHub Copilot.

✅ Les vérifications d'une règle

Vérification	Quoi faire quand elle échoue	Étiquette
CLAUDE.md sous les 200 lignes	Découpez CLAUDE.md en fichiers .claude/rules : gardez-le sous les 200 lignes.	Écrit par la source
Règle Cursor sous les 500 lignes	Découpez la règle : gardez-la sous les 500 lignes.	Écrit par la source
Règle Cursor ciblée	Indiquez alwaysApply, une description ou des globs, pour que Cursor sache quand appliquer la règle.	Choix d'Astrolabe
applyTo renseigné	Indiquez dans applyTo les fichiers auxquels s'appliquent les instructions.	Écrit par la source
AGENTS.md sous les 32 Kio	Raccourcissez AGENTS.md : Codex n'en lit que 32 Kio.	Écrit par la source
Instructions Copilot sous les 4 000 caractères	Raccourcissez les instructions, ou mettez les règles de revue en premier : la revue de code de Copilot lit les 4 000 premiers caractères.	Écrit par la source

Une vérification qui ne concerne pas le fichier sort de sa note : une règle Cursor n'est notée que sur les deux vérifications Cursor. L'onglet Compass les nomme au-dessus de la liste, par exemple 1 évaluation ne concerne pas ce fichier : Dans la limite de Copilot.

Aucune vérification ne concerne un GEMINI.md ni une règle de .claude/rules/. Leur carte affiche Note : aucun contrôle pour ce type de fichier, et leur onglet Compass affiche Aucun contrôle de ce compas ne concerne ce type de fichier : il n'y a rien à noter.

Sources : la mémoire de Claude Code, les règles de Cursor, les instructions de GitHub Copilot, la revue de code de GitHub Copilot et l'AGENTS.md de Codex.

🏢 Ajouter les règles de ton entreprise

Ton entreprise a ses propres règles : une description en français, un tag sur chaque ressource, aucun mot de passe dans un fichier. Écris chacune dans Astrolabe, et chaque ressource qu'elle concerne est notée dessus.

Il te faut le droit de créer et de modifier les évaluations Compass.

Écrire la règle

1. Dans la barre latérale, clique sur Administration, puis Compass, puis l'onglet Évaluations.

2. Clique sur Créer une évaluation. Une fenêtre s'ouvre.

3. Dans Nom, écris le nom de la règle, par exemple Description en français.

4. Dans Description, écris quoi faire quand elle échoue, par exemple Écris la description de l'agent en français. On la lit sous la vérification en échec.

5. Dans Point de données, choisis le type de règle, par exemple Règle de l'entreprise : champ d'en-tête conforme.

6. Dans Passe quand le contrôle est, choisis Vrai.

7. Remplis les réglages sous Paramètres. Pour une description en français :

   • Champ d'en-tête : description
   • Expression régulière : [àâçéèêëîïôûù]
   • Seulement pour ces formats (facultatif) : claude-code/agent

8. Dans Lien vers la page de l'entreprise (facultatif), colle l'adresse de ta page interne sur cette règle, par exemple https://intranet.exemple.com/regles-ia.

9. Clique sur Sauvegarder. La règle apparaît dans la liste, dans le bloc Ressources IA, et un message dit Évaluation créée. Elle compte dans une note une fois ajoutée à un compas : onglet Compas, Modifier, Ajouter une évaluation.

L'ajouter à un compas

1. Clique sur l'onglet Compas. Sur la carte Agents IA, clique sur Modifier.

2. Sous Évaluations, clique sur Ajouter une évaluation. Coche ta règle, puis clique sur Sauvegarder les évaluations choisies.

3. Clique sur Sauvegarder.

✅ C'est fait ! À la prochaine lecture d'une ressource, son onglet Compass montre ta règle. Quand elle échoue, il montre ce qu'il a lu, ce qui est Attendu (par exemple description qui correspond à « [àâçéèêëîïôûù] »), Corriger dans la source, ta description après À faire :, et Règle de l'entreprise, avec Page de l'entreprise.

Les types de règle

Point de données	Réglages	Passe quand
Règle de l'entreprise : champ d'en-tête présent	Champ d'en-tête	Le front matter a ce champ.
Règle de l'entreprise : champ d'en-tête égal à	Champ d'en-tête, Valeur	Le champ a exactement cette valeur.
Règle de l'entreprise : champ d'en-tête conforme	Champ d'en-tête, Expression régulière	Le champ correspond à l'expression.
Règle de l'entreprise : étiquette obligatoire	Étiquette	La ressource a ce tag.
Règle de l'entreprise : au plus N lignes	Nombre de lignes maximum	Le fichier a au plus ce nombre de lignes.
Règle de l'entreprise : au plus N octets	Nombre d'octets maximum	Le fichier pèse au plus ce nombre d'octets.
Règle de l'entreprise : format autorisé	Formats autorisés	Le fichier est dans un de ces formats.
Règle de l'entreprise : le fichier contient	Expression régulière	Une ligne du fichier correspond à l'expression.
Règle de l'entreprise : le fichier ne contient pas	Expression régulière	Aucune ligne du fichier ne correspond à l'expression.

Le Champ d'en-tête des deux règles qui lisent une valeur liste les champs qu'Astrolabe garde : name, description, model, tools, license, applyTo, globs, alwaysApply.

Chaque règle prend aussi Seulement pour ces formats (facultatif) : une liste séparée par des virgules, par exemple agent-skills/SKILL.md, claude-md. Sur un fichier d'un autre format, la règle ne compte pas dans la note.

Format	Fichiers
agent-skills/SKILL.md	un skill (SKILL.md)
claude-code/agent	un agent Claude Code
copilot/agent	un agent GitHub Copilot (*.agent.md)
claude-md	CLAUDE.md
agents-md	AGENTS.md
gemini-md	GEMINI.md
copilot/instructions	.github/copilot-instructions.md
copilot/path-instructions	*.instructions.md
cursor/rule	une règle Cursor (.mdc)
claude-code/rule	une règle dans .claude/rules/

astuce

Une expression régulière suit la syntaxe RE2. (?i) au début ignore la casse : (?i)confidentiel.

Problèmes courants

Ce que la fenêtre dit sous un champ	Quoi faire
Astrolabe ne sait pas exécuter cette expression régulière (RE2 : ni lookaround, ni référence arrière, 500 caractères au plus).	Retire (?=…), (?!…) et \1 de l'expression, ou raccourcis-la.
Nombre de lignes maximum doit être un nombre entier, 0 ou plus.	Écris un nombre sans signe ni décimale, par exemple 300.
Format inconnu : …	Écris les formats exactement comme dans le tableau ci-dessus.
Le lien doit commencer par https:// ou http://.	Colle l'adresse complète de la page.

🔄 Voir la note monter

1. Corrige le fichier dans Git et pousse-le sur la branche par défaut.

2. Dans la barre latérale, clique sur Catalogue, clique sur le composant du dépôt, puis sur l'onglet Ressources IA.

3. Clique sur Relire le dépôt. Quand c'est fini, le message Dépôt relu, note recalculée. apparaît en bas de l'écran.

4. Ouvre la ressource, puis son onglet Compass : la vérification que tu as corrigée a une coche verte.

✅ C'est fait !

astuce

Sans Relire le dépôt, Compass note les ressources IA toutes les 6 heures.

Si tu vois Note : non mesurée ou Pas encore notée à la place d'un chiffre, voir Dépannage.