Nova Skill Creator — Protocole d'Ingénierie de Compétences v2.2
Version 2.4.1 · Motif : Workflow Séquentiel · Type : Échafaudage de Code & Modèles
« Protocole d'Ingénierie de Compétences v2.2 » est le nom du processus que cette compétence suit, pas le numéro de version.
Objectif
Cette méta-compétence transforme toute requête liée aux compétences (nouvelle rédaction / mise à niveau / édition / révision) en un processus d'ingénierie standardisé et produit une compétence professionnelle pouvant être déployée immédiatement. Chaque compétence produite est un « employé virtuel » autonome : soit 1 fichier SKILL.md, soit 1 dossier complet, selon la complexité et l'environnement cible.
Lorsque cette compétence s'active, commencez la réponse exactement par cette phrase : « Protocole d'Ingénierie de Compétences v2.2 activé. Démarrage du processus standard... »
Après cette phrase, répondez dans la langue utilisée par l'utilisateur.
⚠️ Préserver le contenu lors de la réécriture (RÈGLE SUPRÊME)
« Réécrire intégralement » signifie restructurer, PAS compresser/résumer. Lorsque cette compétence est appliquée avec un autre LLM (surtout un modèle plus faible), l'échec le plus courant est que les descriptions techniques sont compressées, les colonnes de tableaux sont coupées, et les schémas/valeurs concrets sont supprimés — le résultat semble plus ordonné mais a perdu du contenu original.
Distinction obligatoire :
| Restructuration (CORRECT) | Compression (FAUSSE) |
|---|---|
| Changer la mise en page, fusionner les sections en double, reformuler | Supprimer des tableaux, lignes, colonnes, exemples |
| Conserver exactement chaque valeur/schéma/ID/règle | Paraphraser un schéma en « à peu près » |
| Nombre d'éléments en sortie >= nombre d'éléments en entrée | Réduire 10 pièges à 4 |
| Augmenter la clarté | Réduire les détails « pour faire plus court » |
Processus anti-compression en 3 étapes — OBLIGATOIRE avant/après chaque réécriture ou mise à niveau :
- Inventaire d'abord (Inventaire de Contenu) : listez chaque élément original qui ne doit PAS être perdu — chaque tableau (avec son nombre de lignes/colonnes), chaque règle de schéma, chaque valeur concrète (ID, version, option), chaque piège, chaque cas de test. Écrivez-le comme une liste de contrôle.
- Réécriture contrainte : pendant la réécriture, chaque élément de la liste doit apparaître en entier dans la sortie. Vous pouvez améliorer la présentation ; vous ne pouvez PAS réduire le nombre d'éléments ni le détail d'un élément.
- Vérification après (Diff Check) : comparez la sortie avec l'inventaire. Si un élément manque, ou si un tableau a moins de lignes/colonnes que l'original → PAS TERMINÉ ; restaurez-le avant de répondre.
Instruction d'auto-contrainte pour le LLM exécutant : « Préserver textuellement chaque tableau, schéma, valeur concrète et piège. Ne pas résumer, ne pas supprimer de détail technique. Si cela doit être plus court, DIVISEZ-LE en références/ ; ne SUPPRIMEZ JAMAIS de contenu. »
Une compétence est un dossier — choisissez la structure selon la complexité
Claude, Claude Code et d'autres agents prennent en charge les compétences sous forme de dossier avec SKILL.md + ressources groupées, avec Divulgation Progressive (les ressources se chargent à la demande), des scripts exécutables hors ligne, et des references/ chargées dynamiquement. Vous n'êtes pas obligé de tout entasser dans 1 fichier.
| Complexité | Structure recommandée |
|---|---|
| Compétence simple et courte | Juste 1 fichier SKILL.md (toujours valide) |
| Compétence avec logique répétitive/déterministe | Dossier + scripts/ |
| Compétence multi-domaine / documentation longue | Dossier + references/ divisé par variante |
| Compétence qui produit des fichiers groupés (modèles/icônes/polices) | Dossier + assets/ |
Principe : choisissez la structure la plus petite qui suffit. Simple → 1 fichier ; complexe → divisez en un dossier pour garder SKILL.md léger. Quand le contenu est trop long → DIVISEZ-LE en references/, ne le compressez PAS.
Anatomie d'une Compétence
nom-de-la-competence-en-kebab-case/
├── SKILL.md (obligatoire)
│ ├── Frontmatter YAML (5 champs pour comptes/LLM libres · UNIQUEMENT nom + description pour les Compétences d'Agent standard — voir 'Variantes par ENVIRONNEMENT CIBLE')
│ └── Instructions Markdown
└── Ressources groupées (optionnel)
├── scripts/ - Code exécutable pour tâches déterministes/répétitives
├── references/ - Documents chargés dans le contexte si nécessaire
└── assets/ - Fichiers utilisés dans la sortie (modèle, icône, police)
Divulgation Progressive (3 niveaux de chargement)
| Niveau | Contenu | Quand entre-t-il dans le contexte |
|---|---|---|
| 1 | Métadonnées (nom + description) | Toujours (~100 mots) |
| 2 | Corps de SKILL.md | Quand la compétence s'active (idéalement sous 500 lignes) |
| 3 | Ressources groupées | Quand nécessaire (references/ se charge dynamiquement ; scripts/ s'exécute sans charger leur contenu dans le contexte) |
Règle : gardez le corps de SKILL.md sous 500 lignes. Quand vous approchez de la limite → divisez en references/ et laissez un pointeur clair dans SKILL.md indiquant où lire. Une référence longue (>300 lignes) doit avoir une table des matières. Diviser est DIFFÉRENT de compresser — diviser garde le contenu intact dans un autre fichier, compresser perd du contenu.
Processus ÉCRIRE UNE NOUVELLE COMPÉTENCE (8 étapes)
| # | Étape | Description |
|---|---|---|
| 1 | Demander les informations manquantes | Objectif, pièges, langue, résultat, environnement cible. Si la conversation contient déjà le workflow → extrayez-le d'abord de l'historique, demandez seulement ce qui manque |
| 2 | Choisir 1 Motif + 1 Type de Compétence | Exactement 1 de chaque (voir les listes ci-dessous) |
| 3 | Écrire la Description en PREMIER | L'étape la plus importante — suivez le Protocole de Description ci-dessous |
| 4 | Choisir la structure + concevoir le contenu | Fichier unique ou dossier ? Qu'est-ce qui reste en ligne, qu'est-ce qui va dans references/, quelle logique devient scripts/ |
| 5 | Écrire SKILL.md | YAML + Workflow + Règles/Schéma + Pièges ; corps sous 500 lignes, décharger les parties longues vers des références |
| 6 | Écrire les scripts/références (si nécessaire) | Logique déterministe/répétitive → scripts/ ; documentation longue → references/ avec des pointeurs |
| 7 | Tester l'activation | 3 cas positifs + 3 cas négatifs |
| 8 | Répondre en utilisant le Format de Sortie | Voir la section Format de Sortie ci-dessous |
LIVRER UNIQUEMENT quand tous les éléments de la Liste de Contrôle 14/14 sont remplis.
Processus MISE À NIVEAU / ÉDITION (8 étapes)
- Lire l'intégralité du SKILL.md actuel (et ses fichiers groupés).
- Inventaire d'abord — listez chaque tableau/schéma/valeur/piège/cas de test qui ne doit PAS être perdu (Règle suprême, étape 1).
- Enregistrer les pièges de l'utilisateur et des exécutions précédentes.
- Évaluer par rapport à la Liste de Contrôle en 14 points.
- Identifier le type de défaillance : Sous-déclenchement / Sur-déclenchement / Erreur d'exécution / Perte de contenu (compression/troncature).
- Réécrire le tout sous la contrainte de préservation — restructurer, ne pas compresser. Ne JAMAIS corriger pièce par pièce.
- Vérifier après — comparer la sortie à l'inventaire, restaurer tout ce qui manque.
- Retester 3 cas positifs + 3 cas négatifs, incrémenter la
version.
Règle de fer : Réécrire intégralement = restructurer en gardant tout le contenu. Pas de rapiéçage. Pas de compression des détails. Conserver l'ancien nom lors de la mise à niveau.
Frontmatter YAML (OBLIGATOIRE)
---
name: nom-de-la-competence-en-kebab-case
version: x.x.x
description: >-
[Description optimisée pour l'activation, sous 1024 caractères, ASCII pur sans signes diacritiques, sans chevrons]
pattern: [1 des 5 Motifs]
type: [1 des 9 Types de Compétence]
---
Variantes par ENVIRONNEMENT CIBLE (demander avant d'écrire le frontmatter)
Le bloc à 5 champs ci-dessus est le modèle pour les comptes claude.ai / Grok / LLM libres. Certaines cibles n'acceptent qu'exactement 2 champs — y soumettre la version à 5 champs échoue immédiatement à la validation, avant même le début de la revue. L'étape 1 (collecte) DOIT demander ou déduire la cible ; en cas de doute, utilisez par défaut la version à 2 champs, car la version à 2 champs fonctionne sur toutes les cibles alors que la version à 5 champs non.
| Cible | Frontmatter | Où vont Version / Motif / Type |
|---|---|---|
| Compte claude.ai, Grok, autres LLM | 5 champs comme dans le modèle ci-dessus, description pliée >- | dans le YAML |
Compétences d'Agent standard (.claude/skills de Claude Code, .agents/skills de Codex) et registres avec validation stricte | UNIQUEMENT nom + description, chacun sur UNE ligne — pas de >-, pas de lignes indentées, pas de troisième champ | une ligne blockquote juste sous le H1 : > **Version x.y.z** · Motif : … · Type : … ; la vraie version vit dans le fichier de registre/manifeste du système cible (le cas échéant) |
Modèle pour les cibles Compétences d'Agent :
---
name: nom-de-la-competence-en-kebab-case
description: "[Description optimisée pour l'activation, UNE ligne, >= 40 caractères, ASCII pur sans signes diacritiques, sans chevrons]"
---
Toujours encadrer une description sur une ligne entre guillemets doubles. Claude Code et Codex lisent le frontmatter avec un analyseur YAML réel. Avec une valeur nue, il y a deux types de dysfonctionnement. (1) Erreur d'analyse — la compétence se charge avec des métadonnées vides et aucun avertissement : un : au milieu (par exemple Vi du: … ou Exemple: …), un : à la fin, commençant par [ { > | ' " * ! % @ , ou un accent grave, ou commençant par - ? : (le caractère suivi d'un espace). (2) Changement silencieux de sens — il est analysé mais erroné : commencer par # rend la description vide, # au milieu coupe le reste, commencer par & le transforme en ancre. Les guillemets doubles évitent les deux ; à l'intérieur des guillemets doubles, n'utilisez pas " ou \.
Les registres avec validation stricte bloquent souvent aussi : les chemins absolus contenant une lettre de lecteur Windows (lettre + deux-points + barre oblique — écrivez <racine>/… au lieu de coder en dur un lecteur), les chaînes qui ressemblent à des identifiants, les liens markdown brisés à l'intérieur du paquet, et tout script .py qui ne force pas stdout/stderr en UTF-8. La révision indépendante rejette aussi souvent une syntaxe qui ne fonctionne que dans le bac à sable de claude.ai (/mnt/skills/…, /mnt/user-data/outputs/, present_files, extract-text) — écrivez des instructions neutres pour l'hôte.
5 Motifs (choisissez exactement 1)
Workflow Séquentiel | Coordination Multi-MCP | Raffinement Itératif | Sélection d'Outils Contextuelle | Intelligence Spécifique au Domaine
9 Types de Compétence (choisissez exactement 1)
Référence Bibliothèque & API | Vérification de Produit | Échafaudage de Code & Modèles | Automatisation de Processus Métier | Récupération & Analyse de Données | Qualité & Révision de Code | CI/CD & Déploiement | Runbooks | Opérations d'Infrastructure
Protocole d'Écriture de la Description (OBLIGATOIRE)
Objectif : taux d'activation de 72 à 90 %.
| Exigence | Détail |
|---|---|
| Phrases de déclenchement | Au moins 5 phrases (dans chaque langue que vos utilisateurs écrivent, romanisées si nécessaire, ex. anglais + vietnamien) |
| Style | Situationnel : « Utiliser lorsque l'utilisateur veut... », « À CHAQUE FOIS QUE... » |
| Exemples réels | Au moins quelques exemples de requêtes que les utilisateurs tapent réellement |
| Longueur | Moins de 1024 caractères |
| Pas de signes diacritiques | Champs YAML uniquement : ASCII pur — supprimez chaque lettre accentuée et marque tonale (ex. vietnamien ă â ê ô ơ ư đ). Pour les langues non écrites en alphabet latin, utilisez des phrases de déclenchement romanisées ou en anglais |
| Pas de chevrons | N'utilisez jamais de chevrons ouvrants/fermants |
| Bloqueur négatif | Terminez par une phrase bloquante : « Ne pas utiliser lorsque... » |
Exemple de Description standard (ASCII pur) :
Utiliser lorsque l'utilisateur souhaite ajouter du contenu à un Wiki IA sur Notion, sauvegarder des connaissances IA,
classer des liens d'articles, des notes, des outils, des prompts. À CHAQUE FOIS QUE l'utilisateur colle un lien,
une note, un nom d'outil ou un prompt IA à conserver. Exemples - sauvegarder ce lien dans le wiki,
ajouter cet outil à notion, garder ce prompt, sauvegarder cet article. Ne pas utiliser lorsque
l'utilisateur pose simplement une question de connaissance ou demande un nouveau contenu sans intention de sauvegarder.
Liste de Contrôle en 14 points (PORTE — 14/14 requis)
| # | Critère | Passe quand |
|---|---|---|
| 1 | nom est correct en kebab-case et ne contient pas « claude »/« anthropic » | ☐ |
| 2 | Le YAML contient nom + version + description (+ motif + type) | ☐ |
| 3 | description répond pleinement au Protocole de Description | ☐ |
| 4 | Pas de chevrons dans la description | ☐ |
| 5 | Corps de SKILL.md sous 500 lignes (les parties longues déchargées vers des références) | ☐ |
| 6 | Exactement 1 Motif + 1 Type de Compétence choisis | ☐ |
| 7 | N'enseigne pas les bases que l'IA connaît déjà | ☐ |
| 8 | A des pièges réels (au moins 5) | ☐ |
| 9 | La structure correspond au besoin : documentation longue divisée en references/ avec des pointeurs clairs | ☐ |
| 10 | La logique répétitive/déterministe est emballée sous forme de scripts/ au lieu d'être décrite manuellement | ☐ |
| 11 | Description optimisée pour l'activation + a un bloqueur négatif | ☐ |
| 12 | Testé 3 cas positifs + 3 cas négatifs | ☐ |
| 13 | Réécrit intégralement (sans rapiéçage) s'il s'agit d'une mise à niveau | ☐ |
| 14 | Diff Check effectué : chaque tableau/schéma/valeur/piège/cas de test original est toujours complet, rien n'a été compressé ou tronqué | ☐ |
Ne répondez à l'utilisateur que lorsque tous les 14/14 sont remplis.
6 Principes d'Or
- N'enseignez pas ce que l'IA connaît déjà — concentrez-vous uniquement sur le contexte spécifique + les pièges.
- Les pièges sont l'actif le plus précieux — enregistrez chaque échec répété.
- Continuez à mettre à jour — chaque erreur = un nouveau piège → mise à niveau immédiate.
- La plus petite structure qui suffit — simple = 1 fichier, complexe = diviser en un dossier et utiliser la Divulgation Progressive.
- Réécrire intégralement = restructurer, pas compresser — préservez complètement le contenu technique ; si c'est trop long, divisez en références, ne le compressez pas.
- Ne rapiécez jamais par morceaux.
Format de Sortie lors de la réponse à l'utilisateur (OBLIGATOIRE, dans cet ordre)
- Résumé de la compétence — objectif, motif, type, structure (fichier unique ou dossier).
- Contenu complet de SKILL.md — dans un bloc de code ; s'il s'agit d'un dossier, listez également les fichiers
references//scripts//assets/. - Guide de déploiement — étapes concrètes pour l'environnement cible.
- Résultats des tests — 3 cas positifs + 3 cas négatifs.
- Diff Check — confirmez qu'aucun contenu original n'a été perdu (s'il s'agit d'une mise à niveau/réécriture).
- Pièges traités — s'il s'agit d'une mise à niveau.
- Version — la version dans le YAML.
Guide de déploiement
Compétence sous forme de dossier (Claude Code / agent / API) :
- Créez le dossier
nom-de-la-competence-en-kebab-case/. - Placez
SKILL.mdà la racine, plusscripts/,references/,assets/le cas échéant. - Installez la compétence comme l'environnement l'attend (dossier du répertoire de compétences ou un paquet
.skill). - Déclenchez 1 invite positive pour confirmer l'activation.
Compétence sous forme de fichier unique (UI d'édition de compétences) :
- Ouvrez l'éditeur de compétences de votre plateforme.
- Copiez l'intégralité du frontmatter YAML + le corps Markdown dans l'éditeur.
- Sauvegardez. Confirmez que la compétence s'affiche en tant que compétence installée.
- Testez avec un cas d'utilisation réel.
Cas de test d'activation (exemples)
| # | Cas | Déclenchement attendu ? |
|---|---|---|
| 1 | « écris une compétence qui enregistre des liens vers Notion » | Oui |
| 2 | « crée une compétence qui trie les e-mails » | Oui |
| 3 | « mets à niveau cette compétence vers v3 » | Oui |
| 4 | « vérifie si cette compétence respecte la norme » | Oui |
| 5 | « corrige le déclencheur de cette compétence » | Oui |
| 6 | « écris un SKILL.md pour ce workflow » | Oui |
| 7 | « c'est quoi une compétence ? » | Non |
| 8 | « explique le concept d'agents IA » | Non |
| 9 | « rédige un article de blog sur les LLM » | Non |