Trois skills pour Claude Code, écrits à partir de pannes réelles rencontrées en montant un assistant IA auto-hébergé sous Windows. Chaque affirmation qu'ils contiennent a été mesurée, pas supposée — plusieurs viennent d'hypothèses que j'ai dû abandonner en cours de route.
| Skill | Ce qu'il couvre |
|---|---|
audit-depot-public |
Auditer un dépôt Git avant de le rendre public : secrets, données personnelles, adéquation du .gitignore, contenu tiers non licencié, choix de licence, vérification depuis l'extérieur. |
docker-selfhost-windows |
Les frictions propres au self-hosting Docker sous Windows : installations perdues à la recréation, HOME non défini par gosu, caches lents sur bind mount, .ps1 cassés par l'encodage, services hôtes qui ne redémarrent pas. |
diagnostic-llm-local |
Diagnostiquer un LLM local lent : GPU bridé malgré 100 % d'utilisation, VRAM mangée par des processus orphelins, contexte tronqué en silence, modèles à raisonnement qui répondent vide. |
- Le taux d'utilisation GPU ne dit pas que le GPU va vite, seulement qu'il est occupé. Une carte peut afficher 100 % à un dixième de sa fréquence, sur un budget électrique contraint. Seule la fréquence sous charge tranche.
- Un dépôt GitHub sans fichier
LICENSEn'est pas libre : c'est tous droits réservés par défaut. L'attribution est une bonne pratique, pas une autorisation — et poser une licence ouverte sur du contenu tiers accorde à autrui des droits qu'on n'a pas. - Un
.gitignorene désindexe rien. Un fichier déjà suivi le reste, même après ajout d'une règle. - Une variable d'environnement vide n'équivaut pas à une variable absente :
os.getenvrenvoie""au lieu du défaut, et la fonctionnalité se dégrade en silence. commande && echo "OK"applaudit dès que le dernier maillon d'un tube réussit. Juger sur l'état réel, pas sur un message qu'on a soi-même écrit.
Copier le dossier voulu dans ~/.claude/skills/ :
cp -r skills/diagnostic-llm-local ~/.claude/skills/Claude Code le détecte au démarrage suivant. Chaque skill est autonome : prendre l'un n'oblige pas à prendre les autres.
Écrits dans un contexte précis — Windows, Docker Desktop, Ollama, dépôts publics sur GitHub — mais les raisonnements se transposent. Ils sont rédigés en français ; le contenu technique (commandes, noms de variables) reste en anglais.
CC BY 4.0 — reprise, adaptation et usage commercial autorisés en créditant l'auteur. Reprenez-les, adaptez-les à votre environnement, corrigez ce qui s'y révèle faux.