HumanLayer Skills : d'abord corriger la structure d'instructions de CLAUDE.md

À qui ça s'adresse

Utilise ce dépôt quand tu utilises déjà Claude Code et que tu veux, avec les skills HumanLayer, changer les instructions du projet ou ajouter une boucle d'agent exécutable. Page officielle :

https://github.com/humanlayer/skills

Page projet :

https://humanlayer.dev/

Prérequis : Claude Code est déjà en local. Les notes n'écrivent pas d'autres clients comme surface supportée ; ne l'étends pas toi-même.

Le chemin d'install principal n'est prouvé que jusqu'à une commande nommée : installer improve-claude-md. La formulation générique montre un espace réservé de nom de skill non donné ; ne copie pas ce nom et n'invente pas d'autres arguments --skill. Les notes n'écrivent pas le répertoire sur disque.

Premier essai en 3 minutes

Install recommandée (écrit des fichiers skill en local ; vérifie d'abord le nom du dépôt et du skill) :

npx skills add humanlayer/skills --skill improve-claude-md

Si la commande échoue, arrête. Après succès, exécute /improve-claude-md dans le projet. Cela réécrit CLAUDE.md avec des blocs <important if>, donc ça change un fichier. Demande d'abord à l'assistant comment il réécrira et quels paragraphes il touchera ; n'autorise l'écriture qu'après confirmation.

Signal de succès : l'assistant a choisi ce skill, peut expliquer comment <important if> améliore le respect des instructions, et n'a pas écrasé CLAUDE.md avant confirmation. S'il commence à changer d'autres fichiers, arrête-le.

Les notes n'écrivent ni étapes de clé ni compte extra.

Cas d'usage

Cas 1 : Réécrire CLAUDE.md. Installe comme ci-dessus et appelle /improve-claude-md. Le but est d'augmenter le respect des instructions avec des blocs <important if>. La première fois, prévisualise seulement dans un projet qui a déjà CLAUDE.md ; s'il manque, arrête. N'invente pas un modèle vide à écraser.

Cas 2 : Resserrer les props d'un composant React. Les notes disent : resserrer les types de props aux vrais chemins de code, pas Storybook, tests, ou états seulement mock. La première fois, fais pointer les types trop larges, puis change les fichiers de types après confirmation. Aucune commande d'install ni slash pour cette capacité ; n'invente pas un nom de skill pour --skill.

Limites d'usage

Le chemin principal n'est écrit que comme :

npx skills add humanlayer/skills --skill improve-claude-md

Le déclencheur n'est prouvé que jusqu'à /improve-claude-md. N'utilise pas un espace réservé de nom de skill jamais donné.

Il écrit aussi : construire des skills dans le dépôt ; un workflow GitHub Actions coding-agent avec itération, plus fichiers prompt, memory et modèles de référence ; et concevoir sensor, controller, actuator et disturbances par questions-réponses, puis en faire des composants exécutables en local plus un workflow minuté. Rien de tout cela n'a de commande d'install ou slash ; ne le fais pas la première fois.

Les notes n'écrivent ni facturation, ni portée de langue, ni répertoire sur disque. La première fois, seulement prévisualiser la réécriture de CLAUDE.md ; ne te jette pas sur GitHub Actions. Les points sans base restent inconnus ; n'invente pas d'opérations ni de noms de skill.