setup-pre-commit

Aperçu de setup-pre-commit

Le skill setup-pre-commit vous aide à mettre en place un flux de travail Git pratique : des contrôles Husky en pre-commit, le formatage avec lint-staged et Prettier, ainsi que, en option, l’exécution de typecheck et des tests avant qu’un code n’entre dans un commit. Il est particulièrement adapté aux dépôts qui disposent déjà d’une chaîne d’outils basée sur Node et qui ont besoin d’une configuration rapide, reproductible et prête à l’emploi plutôt que d’un hook bricolé à la main.

À quoi sert setup-pre-commit

Utilisez le skill setup-pre-commit lorsque vous voulez une protection au moment du commit qui standardise le formatage et détecte tôt les erreurs évidentes. Son vrai rôle n’est pas simplement « installer Husky » : il s’agit de sécuriser les commits locaux sans vous obliger à repenser toute l’architecture du dépôt.

Dans quels cas c’est un bon choix

C’est un excellent choix si votre dépôt utilise déjà Prettier, typecheck et test, ou peut les utiliser, et si vous voulez une convention simple qui fonctionne avec npm, pnpm, Yarn ou Bun. C’est aussi utile lorsque vous devez déployer rapidement une configuration dans un projet existant, avec un minimum de débat sur la politique à adopter.

Ses limites

Ce skill est moins pertinent si votre projet n’est pas basé sur Node, si vous cherchez une logique de commit-msg ou de pre-push plutôt qu’un pre-commit, ou si vos vérifications exigent une orchestration plus avancée qu’un hook simple. Il suppose aussi que vous soyez à l’aise pour vérifier quels scripts existent déjà avant de les ajouter au hook.

Comment utiliser le skill setup-pre-commit

Installez-le et ouvrez les bons fichiers

Installez-le avec npx skills add mattpocock/skills --skill setup-pre-commit. Puis commencez par lire SKILL.md, car c’est là que se trouvent le vrai déroulé et les points de décision. Si votre vue du répertoire n’affiche qu’un seul fichier, cela suffit pour suivre la mise en place, mais il vaut quand même la peine d’inspecter l’arborescence du dépôt pour repérer le gestionnaire de paquets et les scripts déjà présents.

Donnez le bon contexte du dépôt

Pour de meilleurs résultats, indiquez au skill quel fichier lock existe, si package.json contient déjà typecheck et test, et si Prettier est déjà configuré. Une demande solide ressemble à : « Configure setup-pre-commit dans ce dépôt avec pnpm ; conserve la configuration Prettier existante ; ajoute uniquement les scripts qui existent déjà. » C’est bien mieux que « ajoute des hooks pre-commit », car cela évite toute ambiguïté sur le gestionnaire de paquets et le contenu du hook.

Suivez le workflow dans le bon ordre

Le skill est conçu autour d’une séquence simple : détecter le gestionnaire de paquets, installer les dépendances de développement, initialiser Husky, écrire .husky/pre-commit, ajouter lint-staged, puis créer ou réutiliser une configuration Prettier. En pratique, la décision importante consiste à savoir s’il faut inclure npm run typecheck et npm run test, ou les omettre lorsqu’ils n’existent pas. Ce choix permet de garder le hook utile au lieu de le rendre fragile.

Modèle de prompt pratique

Utilisez un prompt qui nomme l’état du dépôt et la politique souhaitée. Par exemple : « Utilise setup-pre-commit pour ajouter Husky, lint-staged et Prettier à ce monorepo. Le fichier lock est pnpm-lock.yaml, typecheck existe, test n’existe pas, et il y a déjà un .prettierrc. » Le skill dispose alors de suffisamment d’informations pour produire une configuration correcte sans inventer de scripts ni écraser la configuration existante.

FAQ sur le skill setup-pre-commit

setup-pre-commit sert-il seulement aux nouveaux dépôts ?

Non. Le skill setup-pre-commit est souvent encore plus utile sur des dépôts existants, car il permet d’ajouter une politique de hooks cohérente sans reconstruire les fichiers manuellement. Il fonctionne d’autant mieux que vous savez déjà quels scripts et quelles configurations sont en place.

Faut-il vraiment Husky et lint-staged ensemble ?

Pour ce workflow, oui, c’est bien l’idée. Husky déclenche le hook, et lint-staged limite le formatage aux fichiers déjà indexés, ce qui permet de garder des commits rapides. Si vous ne voulez qu’une seule de ces deux briques, un prompt générique peut être plus simple que le skill setup-pre-commit.

Va-t-il écraser ma configuration Prettier ?

Pas si vous l’utilisez avec précaution. Le skill ne crée .prettierrc que s’il est absent, et la vraie décision consiste à savoir si votre dépôt possède déjà une configuration de formatage qu’il faut conserver. Si vous avez déjà une politique de style, mentionnez-la explicitement.

Est-ce adapté à la CI ou seulement aux commits locaux ?

Sa valeur principale concerne l’application locale au moment du pre-commit, mais ces vérifications reprennent souvent les attentes de la CI. Si votre CI exécute d’autres commandes, ne copiez pas le hook à l’aveugle : alignez-le sur les scripts réellement utilisés par votre pipeline. C’est le principal point de vigilance pour setup-pre-commit for CI Troubleshooting.

Comment améliorer setup-pre-commit

Donnez au skill les vraies contraintes de votre dépôt

Le plus gros gain de qualité vient du fait d’indiquer à setup-pre-commit quel gestionnaire de paquets, quels scripts et quels fichiers de configuration existent déjà. Si ce contexte manque, vous risquez d’obtenir de mauvais préfixes de commande, la création inutile de scripts, ou des étapes de hook qui échouent au premier commit.

Évitez les échecs de hook les plus courants

L’échec le plus fréquent consiste à ajouter typecheck ou test dans .husky/pre-commit alors que ces scripts n’existent pas. Un autre problème courant est de formater tous les fichiers au lieu des seuls fichiers indexés, ce qui ralentit les commits plus que nécessaire. Si vous voulez un hook fiable, précisez clairement quoi faire lorsqu’un script est absent.

Améliorez le premier résultat avec des cibles explicites

Demandez des résultats concrets, pas seulement une installation. Une consigne plus efficace serait : « Ajoute des hooks pre-commit Husky qui exécutent lint-staged sur les fichiers indexés, conserve la configuration Prettier existante, et inclue typecheck uniquement si package.json le définit déjà. » Vous obtiendrez ainsi un setup-pre-commit guide plus exploitable qu’avec une demande vague.

Itérez après le premier passage

Une fois la configuration initiale en place, vérifiez que le hook correspond aux attentes de l’équipe en matière de rapidité et de rigueur. S’il paraît trop lourd, retirez les vérifications coûteuses du pre-commit et déplacez-les vers la CI ; s’il est trop permissif, ajoutez le script manquant ou restreignez le périmètre de lint-staged. Le meilleur résultat pour setup-pre-commit install est celui que votre équipe conservera réellement.