● Hermes · Skills · Procédures réutilisables

Skills Golden

Ce module restaure les six skills personnalisés du Golden Build, vérifie leur structure et leur sécurité, puis confirme qu’Hermes sait les découvrir. Les secrets restent hors des SKILL.md et les intégrations qui nécessitent une configuration réelle seront finalisées dans les modules suivants.

Point de départ

Hermes sécurisé et stable

Point d’arrivée

Skills Golden disponibles

Source de vérité

~/.hermes/skills/

Avant de commencer

Prérequis

Modules 00 à 07 validés.
Le stockage Golden/NAS du Module 01 est accessible si vous restaurez une sauvegarde.
skills.write_approval et le ledger sont activés.
Vous disposez des répertoires Golden sauvegardés ou des SKILL.md originaux.

Les six skills Golden

strix-halo-local-ai
home-assistant-jarvis
infrastructure-jarvis
coding-automation
jarvis-maintenance
research-watch

Important : les intégrations Home Assistant, réseau, Gmail et Calendar seront configurées dans leurs modules dédiés. Le Module 08 restaure la structure et les instructions des skills ; il ne doit pas inventer de clé ni de secret.

Légende des commandes

Lecture seuleModificationValidationOptionnel

Installation pas à pas

08.1 · Inspecter les skills déjà présents

Lecture seule

hermes skills list
find ~/.hermes/skills -maxdepth 3 -name SKILL.md -print | sort

Pourquoi : Éviter d’écraser un skill déjà installé ou une version plus récente sans l’avoir identifié.

Résultat attendu : La liste des skills présents est connue.

08.2 · Sauvegarder l’arbre de skills actuel

Modification

mkdir -p ~/.hermes/skill-backups
tar -czf ~/.hermes/skill-backups/skills-before-golden-$(date +%Y%m%d-%H%M%S).tar.gz -C ~/.hermes skills

Pourquoi : Créer un rollback local avant toute restauration.

Résultat attendu : Une archive horodatée existe sous ~/.hermes/skill-backups/.

08.3 · Créer les catégories Golden

Modification

mkdir -p ~/.hermes/skills/local-ai \
  ~/.hermes/skills/home-automation \
  ~/.hermes/skills/infrastructure \
  ~/.hermes/skills/coding \
  ~/.hermes/skills/maintenance \
  ~/.hermes/skills/research

Pourquoi : Recréer l’arborescence logique utilisée par le Golden Build.

Résultat attendu : Les six catégories existent.

08.4 · Vérifier la sauvegarde Golden sur le NAS

Lecture seule

find METTRE_VOTRE_POINT_DE_MONTAGE -type f -path "*/skills/*/SKILL.md" -print | sort

Pourquoi : Identifier les fichiers réellement disponibles avant de copier quoi que ce soit.

Résultat attendu : Les SKILL.md Golden apparaissent dans la sauvegarde.

08.5 · Restaurer strix-halo-local-ai

Modification

rsync -a --info=progress2 \
  METTRE_VOTRE_CHEMIN_BACKUP_SKILLS/local-ai/strix-halo-local-ai/ \
  ~/.hermes/skills/local-ai/strix-halo-local-ai/

Pourquoi : Restaurer la connaissance locale liée à Strix Halo, ROCm, Ollama, VRAM/UMA et diagnostics GPU.

Résultat attendu : Le dossier contient SKILL.md et ses éventuels scripts/références.

08.6 · Restaurer home-assistant-jarvis

Modification

rsync -a --info=progress2 \
  METTRE_VOTRE_CHEMIN_BACKUP_SKILLS/home-automation/home-assistant-jarvis/ \
  ~/.hermes/skills/home-automation/home-assistant-jarvis/

Pourquoi : Restaurer les règles de lecture avant action et de confirmation pour la domotique sensible.

Résultat attendu : Le skill Home Assistant est présent. Les secrets ne sont pas copiés dans SKILL.md.

08.7 · Restaurer infrastructure-jarvis

Modification

rsync -a --info=progress2 \
  METTRE_VOTRE_CHEMIN_BACKUP_SKILLS/infrastructure/infrastructure-jarvis/ \
  ~/.hermes/skills/infrastructure/infrastructure-jarvis/

Pourquoi : Restaurer les procédures Linux, systemd, réseau, VPN et supervision réseau.

Résultat attendu : Le skill infrastructure est présent.

08.8 · Restaurer coding-automation

Modification

rsync -a --info=progress2 \
  METTRE_VOTRE_CHEMIN_BACKUP_SKILLS/coding/coding-automation/ \
  ~/.hermes/skills/coding/coding-automation/

Pourquoi : Restaurer les workflows de création, compilation, exécution et validation de code.

Résultat attendu : Le skill coding est présent.

08.9 · Restaurer jarvis-maintenance

Modification

rsync -a --info=progress2 \
  METTRE_VOTRE_CHEMIN_BACKUP_SKILLS/maintenance/jarvis-maintenance/ \
  ~/.hermes/skills/maintenance/jarvis-maintenance/

Pourquoi : Restaurer le workflow de diagnostic global Jarvis en lecture seule.

Résultat attendu : Le skill maintenance est présent.

08.10 · Restaurer research-watch

Modification

rsync -a --info=progress2 \
  METTRE_VOTRE_CHEMIN_BACKUP_SKILLS/research/research-watch/ \
  ~/.hermes/skills/research/research-watch/

Pourquoi : Restaurer le workflow de recherche, suivi planifié et historique.

Résultat attendu : Le skill research-watch est présent.

08.11 · Contrôler qu’aucun secret évident n’est présent

Validation

grep -RniE '(PASSWORD|TOKEN|SECRET|API[_ -]?KEY)[[:space:]]*[:=][[:space:]]*[^<[:space:]]+' ~/.hermes/skills --include='*.md' --include='*.py' --include='*.sh' || true

Pourquoi : Les secrets doivent vivre dans .env et être référencés par variables, pas être codés en dur dans les skills.

Résultat attendu : Aucun secret réel n’est trouvé. Toute occurrence est soit une variable, soit un placeholder.

08.12 · Vérifier les métadonnées des skills

Validation

for f in $(find ~/.hermes/skills -name SKILL.md -type f); do echo "=== $f"; sed -n '1,35p' "$f"; done

Pourquoi : Contrôler le frontmatter, le nom, la description et les requirements avant chargement par Hermes.

Résultat attendu : Chaque skill possède un SKILL.md lisible et cohérent.

08.13 · Vérifier les variables d’environnement déclarées

Lecture seule

grep -Rni 'required_environment_variables' ~/.hermes/skills --include='SKILL.md' || true

Pourquoi : Les secrets nécessaires à un skill doivent être déclarés explicitement afin qu’Hermes les transmette sans les montrer au modèle.

Résultat attendu : Les skills nécessitant des secrets déclarent leurs variables ; les autres peuvent ne rien afficher.

08.14 · Faire reconnaître les skills par Hermes

Validation

hermes skills list | grep -E "strix-halo-local-ai|home-assistant-jarvis|infrastructure-jarvis|coding-automation|jarvis-maintenance|research-watch"

Pourquoi : Valider la découverte depuis la source de vérité ~/.hermes/skills/.

Résultat attendu : Les six skills Golden apparaissent dans la liste.

08.15 · Auditer les skills installés

Validation

hermes skills audit

Pourquoi : L’audit rescanne les skills installés et signale les problèmes de sécurité ou de structure détectables.

Résultat attendu : Aucune alerte bloquante n’empêche l’usage des skills Golden.

08.16 · Relancer une nouvelle session Hermes

Modification

hermes gateway restart
hermes gateway status

Pourquoi : Les nouveaux skills sont indexés dans les nouvelles sessions ; la Gateway doit être relancée pour les canaux persistants.

Résultat attendu : La Gateway est active après redémarrage.

08.17 · Tester un skill sans action sensible

Validation

hermes chat -q "Utilise le skill strix-halo-local-ai et explique en une phrase ce qu’il sert à diagnostiquer. Ne modifie rien."

Pourquoi : Vérifier que le modèle sait charger et exploiter un skill Golden.

Résultat attendu : La réponse fait référence au diagnostic IA locale/Strix Halo sans effectuer de modification.

Secrets et configuration des skills

Secrets

Une clé, un token ou un mot de passe doit rester dans ~/.hermes/.env. Un skill le déclare avec required_environment_variables mais ne contient jamais sa valeur.

Réglages non sensibles

Les chemins, préférences et options peuvent être déclarés comme configuration de skill puis stockés dans config.yaml.

Écritures contrôlées

Avec skills.write_approval=true, une modification créée par l’agent est mise en attente. Utilisez les commandes /skills pending, /skills diff, /skills approve ou /skills reject.

Ledger

Le ledger conserve les mutations des skills et facilite l’audit ou un rollback ciblé. Il ne remplace pas la sauvegarde Golden sur NAS.

Si vous n’avez pas la sauvegarde Golden

Ne recréez pas les six skills de mémoire. Le Golden Build décrit leur rôle, mais pas forcément chaque ligne de leurs scripts. Sans backup ou SKILL.md source, créez uniquement l’arborescence puis reconstruisez chaque skill depuis sa documentation dédiée. Les Modules 09 et suivants fourniront progressivement les intégrations correspondantes.

Références officielles

Validation du Module 08

Ne passez au module suivant que lorsque tous les points applicables sont validés.

Une sauvegarde locale des skills précédents a été créée.

Les six catégories Golden existent.

Les six skills Golden ont été restaurés depuis une source connue.

Aucun secret réel n’est codé en dur dans les fichiers.

Les variables secrètes nécessaires sont déclarées via required_environment_variables.

Chaque skill possède un SKILL.md valide.

hermes skills list affiche les six skills Golden.

hermes skills audit ne signale pas de blocage critique.

La Gateway a été redémarrée après restauration.

Un test de chargement non destructif d’un skill fonctionne.

STOP — Module 08 validé

Si tous les contrôles sont corrects, ce module est terminé. En cas d’écart, restez sur ce module et diagnostiquez la dernière étape en erreur avant de poursuivre.

← Module précédent Revenir à l’ordre des modules