Le guide pas à pas

1.Comprendre ce qu'on installe

Un skill est un fichier d'instructions (SKILL.md, du markdown lisible par un humain) que votre agent IA charge quand la tâche correspond. Vous ne codez rien : vous placez ces fichiers là où votre outil les cherche, et c'est tout. Quand vous direz « nettoie ce repo », l'agent lira le protocole de cleanup-pass et le suivra au lieu d'improviser.

Ce que l'installation fait concrètement : elle télécharge le dépôt une fois, puis crée des liens vers ses skills dans trois dossiers standards (~/.claude/skills pour Claude Code, ~/.agents/skills pour Codex, ~/.cursor/commands pour Cursor). Un seul exemplaire, tous vos outils le voient.

2.Vérifier les prérequis

Il vous faut un terminal et git. Sur Mac, ouvrez l'application Terminal (⌘ + espace, tapez « Terminal », Entrée). Puis vérifiez git :

git --version

~ $ git --version
git version 2.44.0

3.Installer les skills

Deux commandes. La première télécharge le dépôt dans votre dossier courant, la seconde entre dedans et lance l'installeur :

git clone https://github.com/Aximande/agent-skills.git
cd agent-skills && ./install.sh

~ $ git clone https://github.com/Aximande/agent-skills.git
Clonage dans 'agent-skills'...
Réception d'objets: 100%, fait.
~ $ cd agent-skills && ./install.sh
✓ /Users/vous/.claude/skills/cleanup-pass
✓ /Users/vous/.agents/skills/cleanup-pass
✓ ~/.cursor/commands/cleanup-pass.md
… même chose pour chacun des 11 skills …
✓ ~/.cursor/commands/spec-lite.md

4.Vérifier que ça marche

Ouvrez (ou rouvrez) une session de votre agent dans un projet, par exemple Claude Code, et tapez le nom d'un skill précédé d'un slash :

~/mon-projet $ claude
> /cleanup-pass
  cleanup-pass — Repasse de nettoyage sur un repo fonctionnel…

5.Votre premier run, commenté

Lancez /cleanup-pass sur un vrai projet pour voir la mécanique. Voici à quoi ressemble un run, et ce que chaque moment veut dire :

> /cleanup-pass
Préflight : 42 tests verts, build OK. Baseline posée.
   ① le skill relève d'abord l'état de VOS tests : c'est son filet
Passe 1 : dead code retiré dans utils.py (−38 lignes)…
Gate : tests 42/42 verts, build OK → commit.
   ② chaque changement n'est commité que si vos tests restent verts
Rapport : 2 propositions non commitées dans .cleanup/
(refactor risqué → à vous de décider)
   ③ ce qui ne peut pas être prouvé part en rapport, jamais en commit

Trois choses à retenir : le skill montre son filet avant de toucher quoi que ce soit, chaque commit est gaté par vos propres tests, et ce qui est risqué finit en rapport pour votre décision, pas en modification silencieuse. Tous les skills du dépôt suivent cette même logique.

6.Sur les autres outils

Cursor

Il n'y a rien à installer dans Cursor lui-même : tout se passe au terminal, à l'étape 3.

Codex CLI (OpenAI)

Claude (application de bureau et claude.ai)

ChatGPT, Gemini, ou tout autre chat

Lis ce document et exécute-le exactement comme prescrit,
du préflight à la livraison, sans sauter d'étape.

Certains skills demandent un outil en plus

Sans l'outil, le skill vous le dit au préflight et bascule en mode dégradé quand c'est possible, au lieu d'inventer un résultat.

7.Mettre à jour, désinstaller

Mettre à jour : les skills sont des liens vers votre clone, donc une seule commande met tout à jour, pour tous les outils :

cd agent-skills && git pull

Désinstaller : supprimez les liens (vos autres skills ne sont pas touchés, on ne supprime que ceux de ce dépôt) :

cd agent-skills
for s in skills/*/; do n=$(basename "$s");
  rm -f ~/.claude/skills/"$n" ~/.agents/skills/"$n" ~/.cursor/commands/"$n".md;
done

8.Dépannage

Un cas non couvert ? Ouvrez une issue.