From 893957703acfd211f0f05ff255b0c47ca445fd97 Mon Sep 17 00:00:00 2001
From: Gilles Soulier <gil.soulier@gmail.com>
Date: Sat, 16 May 2026 05:59:37 +0200
Subject: [PATCH] =?UTF-8?q?feat:=20install.sh=20=E2=80=94=20aide=20F1=20av?=
 =?UTF-8?q?ec=20ic=C3=B4nes,=20raccourcis=20et=20variables=20d'env?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Ajoute un fichier d'aide accessible via F1 (less -R) depuis le menu fzf.
Documente : états (✓↑+·), actions (●L●G○), raccourcis (SPACE/TAB/v/F1),
arbre des catégories et variables d'environnement.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 install.sh | 53 +++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 51 insertions(+), 2 deletions(-)

diff --git a/install.sh b/install.sh
index eb302b1..b4c5b4c 100755
--- a/install.sh
+++ b/install.sh
@@ -581,8 +581,56 @@ PREVIEW_EOF
     sed -i "s|FNSFILE|$fns_file|" "$preview_script"
     chmod +x "$preview_script"
 
+    # Fichier d'aide F1
+    local help_file="/tmp/skills_help_$$.txt"
+    cat > "$help_file" << HELP_EOF
+$(echo -e "${GRV_PURPLE}╔══════════════════════════════════════════════════════════╗
+║          AIDE — mes_skills installer (F1 pour fermer)    ║
+╚══════════════════════════════════════════════════════════╝${RESET}")
+
+$(echo -e "${GRV_BLUE}NAVIGATION${RESET}")
+  $(echo -e "${GRV_YELLOW}↑ ↓${RESET}")        Déplacer le curseur
+  $(echo -e "${GRV_YELLOW}Taper${RESET}")       Filtrer par nom ou description
+  $(echo -e "${GRV_YELLOW}ENTER${RESET}")       Confirmer les sélections et lancer l'installation
+  $(echo -e "${GRV_YELLOW}ESC${RESET}")         Quitter sans installer
+  $(echo -e "${GRV_YELLOW}q${RESET}")           Fermer cette aide
+
+$(echo -e "${GRV_BLUE}ÉTATS DES SKILLS${RESET}")
+  $(echo -e "${GRV_GREEN}✓${RESET}")           Déjà installé (même version)
+  $(echo -e "${GRV_YELLOW}↑${RESET}")           Mise à jour disponible (version dépôt > locale)
+  $(echo -e "${GRV_AQUA}+${RESET}")           Nouveau skill (pas encore installé)
+  $(echo -e "${GRV_GRAY}·${RESET}")           Non applicable (agent non sélectionné)
+
+$(echo -e "${GRV_BLUE}ACTIONS  (SPACE pour cycler)${RESET}")
+  $(echo -e "${GRV_GREEN}●L${RESET}")          Installer en LOCAL  → .claude/skills/ (dossier courant)
+  $(echo -e "${GRV_BLUE}●G${RESET}")          Installer en GLOBAL → ~/.claude/skills/
+  $(echo -e "${GRV_GRAY}○${RESET}")           Ignorer — ne pas installer ce skill
+  $(echo -e "${GRV_YELLOW}↑${RESET}")           Mettre à jour (visible uniquement si MAJ disponible)
+
+$(echo -e "${GRV_BLUE}RACCOURCIS CLAVIER${RESET}")
+  $(echo -e "${GRV_GREEN}SPACE${RESET}")       Changer l'action du skill sélectionné
+  $(echo -e "${GRV_GREEN}TAB${RESET}")         Plier / déplier la catégorie
+  $(echo -e "${GRV_GREEN}v${RESET}")           Afficher / masquer le contenu du skill (preview)
+  $(echo -e "${GRV_GREEN}F1${RESET}")          Afficher / fermer cette aide
+
+$(echo -e "${GRV_BLUE}ARBRE DES CATÉGORIES${RESET}")
+  $(echo -e "${GRV_BLUE}▼${RESET} dev/")       Catégorie dépliée — TAB pour replier
+  $(echo -e "${GRV_YELLOW}▶${RESET} infra/")     Catégorie repliée  — TAB pour déplier
+  $(echo -e "${GRV_GRAY}Les catégories avec >3 skills sont repliées par défaut.${RESET}")
+
+$(echo -e "${GRV_BLUE}VARIABLES D'ENVIRONNEMENT${RESET}")
+  $(echo -e "${GRV_FG}SKILLS_AGENT=claude${RESET}")    Forcer un seul agent
+  $(echo -e "${GRV_FG}SKILLS_TAG=bash${RESET}")        Filtrer par tag
+  $(echo -e "${GRV_FG}SKILLS_DRY_RUN=1${RESET}")       Simuler sans écrire
+  $(echo -e "${GRV_FG}SKILLS_DEBUG=1${RESET}")          Affichage détaillé
+  $(echo -e "${GRV_FG}SKILLS_REPO=/chemin${RESET}")    Utiliser un dépôt local
+
+$(echo -e "${GRV_GRAY}─────────────────────────────────────────────────────────${RESET}")
+$(echo -e "${GRV_GRAY}Dépôt : https://gitea.maison43.duckdns.org/gilles/mes_skills${RESET}")
+HELP_EOF
+
     local legend
-    legend=$(echo -e "${GRV_GRAY}État: ${GRV_GREEN}✓ ${GRV_YELLOW}↑ ${GRV_AQUA}+   Action: ${GRV_GREEN}●L ${GRV_BLUE}●G ${GRV_GRAY}○   SPACE=action  TAB=plier  v=voir  ENTER=ok  ESC=quitter${RESET}")
+    legend=$(echo -e "${GRV_GRAY}État: ${GRV_GREEN}✓ ${GRV_YELLOW}↑ ${GRV_AQUA}+   Action: ${GRV_GREEN}●L ${GRV_BLUE}●G ${GRV_GRAY}○   SPACE=action  TAB=plier  v=voir  F1=aide  ENTER=ok  ESC=quitter${RESET}")
 
     fzf \
         --ansi \
@@ -596,9 +644,10 @@ PREVIEW_EOF
         --bind="space:execute-silent(bash $space_script {1})+reload(bash $list_script)+pos({n})" \
         --bind="tab:execute-silent(bash $tab_script {1})+reload(bash $list_script)" \
         --bind="v:toggle-preview" \
+        --bind="f1:execute(less -R $help_file)" \
         < <(bash "$list_script") > /dev/null || true
 
-    rm -f "$space_script" "$tab_script" "$list_script" "$fns_file" "$preview_script"
+    rm -f "$space_script" "$tab_script" "$list_script" "$fns_file" "$preview_script" "$help_file"
 }
 
 # ── Installation ──────────────────────────────────────────────────