promote

Présentation du promote skill

À quoi sert promote

Le promote skill transforme un comportement Claude répété et validé, jusque-là stocké dans l’auto-mémoire, en règle explicite de projet. Au lieu de laisser un schéma utile enfoui dans MEMORY.md, promote aide à le déplacer vers CLAUDE.md, .claude/rules/<topic>.md ou un fichier global d’instructions Claude, afin que ce comportement soit appliqué de façon cohérente dans les sessions futures.

Idéal pour les workflows Claude qui s’améliorent avec le temps

Utilisez promote lorsque votre équipe laisse déjà Claude apprendre à partir de corrections, de préférences et de conventions de projet récurrentes, mais qu’un de ces apprentissages doit désormais devenir durable. C’est particulièrement utile dans les configurations de Context Engineering, où MEMORY.md capture les observations et où les fichiers de règles définissent ce que l’agent doit suivre de manière fiable.

De bons exemples seraient « toujours utiliser pnpm dans ce repo », « les handlers API doivent valider les entrées » ou « les tests du code de facturation nécessitent ces fixtures ». De mauvais exemples seraient des préférences ponctuelles, des débats non tranchés ou des règles dont l’efficacité n’a pas encore été constatée en pratique.

Ce qui rend ce promote skill utile

Ce skill ne se limite pas à rappeler de copier-coller une consigne. Il propose un workflow de décision : clarifier le schéma, retrouver les entrées de mémoire qui l’appuient, choisir le bon fichier cible, rédiger une règle applicable et conserver la mémoire d’origine avec une note de promotion. C’est important, car la partie difficile n’est pas de modifier du markdown ; c’est de décider si une mémoire mérite d’être appliquée de façon permanente et où cette règle doit vivre.

Comment utiliser le promote skill

Installation de promote et lecture du repository

Installez le skill depuis la collection GitHub avec :

npx skills add alirezarezvani/claude-skills --skill promote

Lisez ensuite SKILL.md en premier. À l’heure actuelle, ce chemin de repository expose le workflow promote dans un seul fichier : il n’y a donc ni scripts auxiliaires, ni références, ni modèles de règles à examiner. Cela rend l’adoption simple, mais cela signifie aussi que vous devez relire attentivement les exemples de commandes et le tableau de choix de cible avant de l’utiliser sur un repo important.

Appeler promote en pratique

Le déclencheur prévu est /si:promote, suivi du schéma que vous voulez rendre permanent :

• /si:promote use pnpm instead of npm
• /si:promote API handlers need validation --target rules/api.md
• /si:promote tests for auth changes must include session expiry cases --target rules/testing.md --paths "src/auth/**/*.ts"

Le skill vérifie d’abord le comportement que vous voulez formaliser. Si votre demande est vague, il doit poser une seule question de clarification, par exemple pour savoir si la règle s’applique globalement ou seulement à certains chemins. Il recherche ensuite les entrées liées dans le fichier d’auto-mémoire Claude du projet, sous ~/.claude/projects/.../memory/MEMORY.md, affiche les correspondances et confirme que la mémoire justifie la promotion.

Transformer un objectif flou en prompt solide

Un prompt faible dirait : « promote our testing preference ». Une meilleure utilisation de promote précise le comportement, les preuves, le périmètre et la cible si elle est connue :

/si:promote "When changing billing code, add regression tests for failed payment and retry paths" --target rules/testing.md --paths "src/billing/**/*.ts"

Cela fonctionne mieux parce que le skill peut rédiger une règle applicable plutôt qu’une préférence vague. Indiquez :

• le comportement exact que Claude doit suivre
• s’il s’applique à tout le projet, à certains types de fichiers ou à tous les projets
• des exemples de chemins si la règle est limitée à un périmètre
• la formulation mémorisée ou l’incident qui a montré l’utilité du schéma

Workflow conseillé avant de merger la règle

Après que promote a rédigé ou modifié la règle, relisez-la comme une configuration de production. Vérifiez que l’instruction est courte, testable et pas plus large que ce que les preuves permettent de justifier. Pour un comportement valable sur tout le projet, CLAUDE.md est généralement approprié. Pour un comportement plus ciblé, privilégiez .claude/rules/<topic>.md avec un périmètre de chemins. Pour une convention personnelle commune à plusieurs repositories, n’utilisez un fichier global d’instructions Claude que si le schéma est réellement universel.

FAQ du promote skill

promote convient-il au Context Engineering ou au prompting général ?

Promote est surtout utile pour le Context Engineering, car il formalise le passage d’un comportement observé à une instruction persistante. Les prompts généraux peuvent demander à Claude de mémoriser quelque chose pour une session ; promote aide à décider si cet apprentissage doit devenir une partie du contexte opérationnel du repo.

Quand ne faut-il pas utiliser promote ?

N’utilisez pas promote pour des idées non testées, des contournements temporaires, des goûts personnels qui entrent en conflit avec les normes de l’équipe, ou des instructions qui devraient plutôt être portées par le code applicatif, les tests, les linters ou la CI. Une règle est utile lorsqu’elle guide le comportement de l’agent ; elle devient risquée lorsqu’elle remplace une enforcement exécutable.

En quoi est-ce différent d’une modification manuelle de CLAUDE.md ?

Modifier manuellement peut fonctionner, mais cela saute souvent les étapes de preuve et de périmètre. Le promote skill ajoute un processus reproductible : retrouver la mémoire, confirmer le comportement attendu, choisir la bonne destination et laisser une trace indiquant que la mémoire a été promue. Cela limite la prolifération des règles et aide les mainteneurs futurs à comprendre pourquoi l’instruction existe.

promote est-il accessible aux débutants ?

Oui, si l’utilisateur comprend déjà où se trouvent la mémoire de son projet Claude et ses fichiers de règles. Les débutants devraient commencer par un seul schéma clair à l’échelle du projet, utiliser --target claude.md, puis éviter les règles limitées à certains chemins tant qu’ils ne sont pas à l’aise avec les conventions de .claude/rules/.

Comment améliorer le promote skill

Améliorer les résultats de promote avec de meilleures preuves

Le promote skill donne de meilleurs résultats lorsque la mémoire source est précise. Avant de l’invoquer, rassemblez l’entrée de mémoire exacte, la correction ou l’échec répété qui prouve que la règle est nécessaire. « Claude keeps using npm » est moins solide que « In three sessions Claude ran npm commands, but this repo uses pnpm and has no package-lock.json. »

Éviter les échecs courants de promotion

L’échec le plus fréquent est la sur-promotion : transformer une observation étroite en consigne globale. Un autre problème consiste à écrire des règles qui sonnent bien mais ne sont pas actionnables, comme « write better tests ». Une meilleure règle nomme le déclencheur, l’action requise et le périmètre : « For src/api/**/*.ts, validate request bodies before calling service functions. »

Itérer après la première règle générée

Après la première sortie de promote, demandez-vous si la règle est trop large, trop vague ou déjà présente ailleurs. Affinez-la ensuite. Exemples de prompts de suivi utiles :

• “Make this rule enforceable in one paragraph.”
• “Narrow this to only API route files.”
• “Add one example and one non-example.”
• “Check whether this belongs in CLAUDE.md or .claude/rules/testing.md.”

Garder un système de règles sain

Un bon guide promote doit empêcher la couche de règles de devenir bruyante. Passez régulièrement en revue les règles promues pour détecter les conflits, les conventions obsolètes et les instructions qui devraient être déplacées vers l’outillage. Le meilleur résultat avec promote n’est pas d’avoir plus de markdown ; c’est d’avoir moins de corrections répétées, parce que Claude reçoit désormais le bon contexte durable, au bon niveau de périmètre.